Content cards let your agent surface contextual content during a live conversation - a product image, a demo video, a pricing page, a tutorial clip - at exactly the right moment, based on what the visitor is talking about.
How to add content cards to your Space
In the administration panel, navigate to the Content tab for your Space. Each card you add has four fields:
- Name - a label for your own reference so you can identify the card in the list.
- Trigger condition - a plain-language description of when the card should appear. For example: "When the user asks about pricing, costs, or plans." or "When the user mentions returns or refunds."
- Content type - choose from a website link, a YouTube video, an uploaded video, or an image.
- Description (optional) - text that appears on the card alongside the content.
You can add as many cards as you like per Space.
How triggers work
The agent monitors the conversation in real time and surfaces a card when the conversation matches your trigger condition. Triggers use natural language - write them the way you would describe the moment to a colleague.
Good trigger examples:
- "When the user asks about pricing, cost, or subscription plans"
- "When the user asks to see a demo or how the product works"
- "When the user mentions a specific product name"
Important: Content cards are not controlled by the Persona Prompt editor. Adding card instructions to your prompt will not cause cards to appear. Cards are configured exclusively through the Content tab and fire based on their trigger conditions.
Can I make a card appear automatically at the start of the session?
No. Cards require a conversational trigger - something the visitor says or asks. There is currently no option to show a card immediately at session start or right after the agent intro without a voice or text trigger from the visitor. This is a current product limitation.
Default cards vs content cards
Spaces has two separate card systems:
- Default cards - shown automatically when a session starts. These are AI-generated from the underlying website URL. You cannot control their content through the prompt. If they are showing irrelevant information, you can disable them - but note that disabling default cards changes the companion layout (the agent moves to the centre of the screen).
- Content cards - cards you configure manually with specific content and trigger conditions. These give you full control over what appears and when.
Companion position when cards are disabled
When default cards are turned off, the companion moves to the centre of the Spaces experience. To keep the companion in a corner position on your parent website, adjust the iFrame CSS position on the parent page. See Embedding Napster Spaces on Your Website for iFrame positioning details.
Image cards - recommended dimensions
When using an image as card content, note that the display dimensions differ between the Preview and the live runtime. Use a 16:9 aspect ratio image at 1280x720px or higher for best results. The image will be made clickable to open full-screen in an upcoming update.
Still need help setting up cards? Submit a ticket with your Space URL and a description of what you are trying to achieve.