Data
What are Data Items?
Data Items are the files you upload to your agent — images, documents, and other media. Once uploaded, they live in your agent's file library and can be referenced from elsewhere: as product images in your catalog, as screenshots attached to widgets, or as knowledge base content the AI agent can use in conversation.
Every Data Item is stored securely and accessible via a signed URL. The agent is aware of the files you upload and can reference them when relevant.
Upload a File
Navigate to Data in the left sidebar. Click Upload in the top-right corner.
Select a file from your computer. After the upload completes, the file appears in your Data library with its name, type, and size filled in automatically.
You can optionally add a description right after uploading. Descriptions are internal — use them to note what the file is for, which product it belongs to, or any other context that helps you and your team find it later.
Supported File Types
Data Items support a range of file types:
| Category | Formats | |----------|---------| | Images | JPEG, PNG, WebP, GIF, SVG | | Documents | PDF | | Other | Any file type can be uploaded, but display support may vary |
The MIME type is detected automatically when you upload the file. You do not need to specify it manually.
File Details
Each Data Item has the following details:
| Field | Description | |-------|-------------| | Name | The display name of the file. Auto-filled from the filename on upload — you can rename it at any time | | MIME Type | Detected automatically from the file content on upload | | Size | File size, calculated automatically | | URL | A signed URL for accessing the file, valid for 1 year | | Description | Optional internal note about the file's purpose or context |
About Signed URLs
The URL for each Data Item is a signed link — it includes a security token that expires after one year. This means the file is not publicly accessible via a plain URL; only requests with a valid signed link can access it.
If a URL expires, you can generate a fresh one from the Data Item's detail page.
Where Data Items Are Used
Data Items are referenced from other parts of emercai:
Product Attributes — When you add an image attribute to a product, you link it to a Data Item from your library. This keeps your product images organized in one place and avoids duplicates.
Widget Screenshots — Each widget can have a screenshot attached. That screenshot is stored as a Data Item and shown on the widget's detail page for internal reference.
Knowledge Base — Data Items such as PDFs and documents can serve as knowledge base content, giving the agent access to specific information you provide.
Settings Reference
| Setting | Description | |---------|-------------| | Name | Display name of the file, editable at any time | | Description | Internal note about the file's purpose | | MIME Type | Set automatically on upload, not editable | | Size | Set automatically on upload, not editable | | URL | Signed access URL, valid for 1 year |
Manage Your Data
Search
The Data list shows all files in your agent's library. Use the search field at the top to filter by name.
Rename a File or Update the Description
Click on any Data Item in the list to open its detail page. From there you can rename the file and edit the description. The filename change is internal — the file on the server keeps its original storage path, so existing links to the file continue to work.
Delete a File
Open the Data Item's detail page and use the delete option at the bottom of the page.
Deleting a Data Item removes the file from storage and the entry from your library. If the file was linked from a product attribute or widget, that link will break. Review where a file is used before deleting it.
Deletion is permanent. The file cannot be recovered once deleted.
FAQ
How long do signed URLs last? One year from when they were generated. After that, the URL expires and you need to generate a new one from the Data Item's detail page.
Can I replace a file without losing the link? Not directly — uploading a new file creates a new Data Item with a new URL. If you need to update a file that is already linked from a product or widget, upload the new version, then update the link in the product attribute or widget to point to the new Data Item.
Is there a file size limit? Storage limits depend on your plan. Check your account settings for current limits. Very large files such as high-resolution video are not recommended — the agent cannot process them directly.
Are files shared across agents? No. Each agent has its own Data library. Files uploaded to one agent are not visible or accessible from another agent.
What happens to files when I delete a product? The Data Items themselves are not deleted when a product is deleted. Only the link between the product attribute and the Data Item is removed. The file stays in your library and can be used elsewhere.