# Media Chat agents read your media library during every conversation and proactively surface the most relevant file at the right moment — without you scripting every interaction. When a lead asks for a product demo, a case study, or a pricing overview, the agent pulls up the right asset and presents it naturally, the same way a rep would reach for the right slide deck. {% hint style="info" %} Media is currently supported by Chat agents only (Spara Navigator, Smartbar, and Fullscreen). {% endhint %} ## How media appears in chat When an agent shows a file, a media panel slides out to the left of the conversation. The lead can view the media while continuing to chat — videos, PDFs, and images all render inline in this panel, so leads never have to leave the page.

Spara Navigator with a media panel open alongside the chat window.

## Setting up your media library Navigate to [**Media**](https://app.spara.co/ai-training/media) and click **Upload File**. Each asset has three fields the agent uses to decide when and whether to show it: **Name** — The label displayed to the lead when the file is shown. Use something clear and human-readable, like "Product Overview" or "Q3 Case Study — Enterprise." **Description** — A detailed explanation of what the asset contains. The agent reads this to understand the file's content. The more specific, the better the agent's decision-making — describe the topics covered, the audience it's best for, and any key proof points. **When to Show** — A plain-language description of the situations in which this file is relevant. The agent reads this to know when to surface the asset (see [#writing-effective-when-to-show-descriptions](#writing-effective-when-to-show-descriptions "mention")). **Visibility** — Set to **Visible** to make the file active. Set to **Hidden** to remove it from the agent's options without deleting it. ### Writing effective "When to Show" descriptions The "When to Show" field is what tells the agent the right moment to surface a file. Write it as a bulleted list of intent signals — what would a lead say or ask that makes this asset relevant? **Good example** for a product demo video: * Lead asks to see a product demo or walkthrough * Lead expresses interest in understanding how the platform works * Lead asks "what does it look like" or "can you show me" **Good example** for a pricing overview PDF: * Lead asks about pricing, cost, or plans * Lead asks to compare tiers or packages * Lead is ready to move forward and wants to understand the investment **Tips:** * Use plain language, not exact-match phrases. The agent understands intent, not just keywords. * One file per specific use case. Focused conditions perform better than a single catch-all file. * Revisit conditions after reviewing conversations. If a file is appearing at the wrong moment, tighten the description. ### Keeping your library current Because the agent reads asset details directly from the Media library, you can update what it shows without touching your agent's prompt: * **Add a new asset** with a clear description and "When to Show" — the agent picks it up automatically * **Update an existing asset's description** to shift when and how the agent uses it * **Set an asset to Hidden** to remove it from the agent's options immediately ## Guiding media from the agent prompt You can give your chat agent explicit instructions in its prompt about how to handle media — which assets to prioritize, when to proactively offer them, how to introduce them, and when to hold back. For details and examples, see the [#media](https://docs.spara.com/agents/agent-overview/agent-editor#media "mention"). ## Supported file formats | Type | Common uses | | --------------------- | -------------------------------------------------- | | Video (mp4, mov) | Product demos, explainers, customer testimonials | | Image (png, jpg, gif) | Feature screenshots, comparison charts, one-pagers | | PDF | Pricing sheets, case studies, whitepapers | ## FAQ ### How many media files can I have? There is no hard cap. Use Hidden to archive files you no longer need rather than deleting them, so you can reactivate them later. ### Can the same file be shown by multiple agents? Yes. Media files are shared across all chat agents in your account. Any Visible file can be shown by any active chat agent when its "When to Show" conditions are met. ### How do I know if a media file is working? Test it in the [testing](https://docs.spara.com/platform/testing "mention") interface: start a conversation and steer it toward a trigger condition you defined. If the media panel opens, the condition matched. If it doesn't appear, try expanding or rephrasing the "When to Show" description. ### Can I control which agent shows which file? Not directly by agent — Visible files are available to all chat agents. If you need a file to be agent-specific, set it to Hidden and coordinate with your prompt instructions to guide which agent uses it and when. For a step-by-step walkthrough of setting up media from scratch, see [https://docs.spara.com/guides/using-media-in-chat-agents](https://docs.spara.com/guides/using-media-in-chat-agents "mention").