File Store Feature

The File Store is a powerful file management system built into the Deployment Portal that gives you complete control over the resources your deployments need. Whether you're managing grammar files for speech recognition, lexicons for language models, SSML templates for text-to-speech, or any other deployment assets, File Store provides an intuitive interface to upload, organize, and manage your files with confidence.

Why File Store Matters

Modern speech and AI deployments rely on a variety of supporting resources—grammars that define recognition patterns, lexicons that improve pronunciation accuracy, audio prompts, configuration files, and more. Managing these resources across multiple deployments and environments can quickly become complex.

File Store addresses this challenge by providing:

• Centralized storage tied directly to each deployment
• Real-time quota monitoring so you always know your resource utilization
• Flexible organization through an intuitive folder hierarchy
• Direct URLs for seamless integration with your applications

Getting Started

Accessing File Store

Navigate to your deployment in the portal and select File Store from the deployment menu. You'll be presented with two primary views:

Dashboard — A high-level overview of your storage utilization, including quota status, recent files, folder statistics, and a breakdown of file types in your deployment.

File Browser — A detailed view for managing individual files and folders, with search, filtering, and sorting capabilities.

Understanding Your Dashboard

The Dashboard provides immediate insight into your deployment's file storage:

Working with Files

Uploading Files

File Store supports multiple upload methods to fit your workflow:

Drag and Drop — Simply drag files from your desktop directly into the File Browser area. An overlay will confirm the drop zone, and files will be uploaded to the currently selected folder.

File Picker — Click the upload button to open a standard file selection dialog. Multiple files can be selected at once.

Organizing with Folders

Create a logical folder structure that mirrors your application architecture or workflow:

1. Right-click in the folder tree or click the Create Folder button
2. Enter a descriptive folder name
3. Files can then be uploaded directly to that folder or moved there later

Folders can be nested to any depth, allowing you to create structures like:

grammars/
  en-US/
    commands/
    dictation/
  es-MX/
    commands/
lexicons/
  custom/
prompts/
  welcome/
  errors/

Finding Files

As your file collection grows, File Store provides several tools to locate what you need:

Search — Enter a filename or partial match in the search box. Results update as you type.

Filters — Use advanced filtering to narrow results by:

• File type (images, audio, XML, JSON, grammars, and more)
• Size range (find large files consuming quota, or small configuration files)
• Date range (locate recently modified files or historical resources)

Sorting — Click column headers to sort by filename, size, or modification date. Click again to reverse the sort order.

File Actions

Right-click any file to access the context menu, or use the action buttons in the file row:

Using File URLs in Your Applications

Every file in File Store has a unique URL that can be used directly in your applications. To obtain a file's URL:

1. Locate the file in the File Browser
2. Click the copy icon in the URL column, or right-click and select Copy URL

These URLs can be used in:

• Grammar references in ASR configurations
• Lexicon paths in TTS settings
• Audio prompt URLs in call flows
• Any application that needs to reference your stored resources

Best Practices

Organize by Purpose

Structure your folders around how resources are used rather than just file type. For example:

production/
  grammars/
  lexicons/
staging/
  grammars/
  lexicons/

This makes it easy to manage resources across different environments.

Monitor Your Quota

Regularly check the Dashboard to understand your storage utilization. If you're approaching quota limits:

• Archive or remove outdated files
• Consolidate duplicate resources
• Review large files that may have alternatives

Use Descriptive Names

Choose filenames that clearly indicate purpose and version:

• menu-options-v2.grxml is more useful than grammar1.grxml
• en-us-medical-terms.lex tells you exactly what the lexicon contains

Leverage Metadata

File Store tracks creation and modification timestamps automatically. Use the metadata view to:

• Verify you're working with the latest version
• Audit when files were last changed
• Confirm file integrity via checksums

Keyboard Shortcuts

For power users, File Store supports keyboard navigation:

Supported File Types

File Store accepts any file type. The system automatically detects and categorizes common formats:

• Grammar files — GRXML, GRAM, ABNF, and other speech recognition grammars
• Lexicons — Custom pronunciation dictionaries
• Audio — WAV, MP3, and other audio formats for prompts
• SSML — Speech Synthesis Markup Language templates
• Configuration — JSON, XML, and text-based configuration files
• Documents — PDF, text files, and documentation

Frequently Asked Questions

What happens if I upload a file that already exists?

File Store will detect the conflict and ask whether you want to overwrite the existing file or cancel the upload. This prevents accidental overwrites.

Can I move files between folders?

Yes. Use the rename function to change a file's path. For example, renaming grammars/old.grxml to archive/old.grxml effectively moves the file.

How do I delete multiple files at once?

Select multiple files using Ctrl+Click (or Cmd+Click on Mac), then press Delete or use the delete action. You can also delete an entire folder, which removes all files within it.

Are my files backed up?

File Store is designed with reliability in mind. Contact your administrator for details on your specific deployment's backup policies.

What's the maximum file size I can upload?

File size limits depend on your deployment configuration. If you encounter upload issues with large files, contact your administrator.

Related Resources

• Product Glossary — Definitions of terms used in this documentation
• Integration Documentation — Guides for integrating resources with your applications