Home Screen Cards
Cards are the interactive building blocks of your home screen. Each card serves a different purpose — from starting a conversation to browsing help articles or opening a form. You can add, remove, and reorder cards from Settings → Widget → Home.
Cards are the interactive building blocks of your home screen. Each card serves a different purpose — from starting a conversation to browsing help articles or opening a form. You can add, remove, and reorder cards from Settings → Widget → Home.
Cards appear stacked vertically in the exact order you arrange them in the dashboard.
Card Types
ASK (AI Assistant)
The ASK card is an interactive input field with an animated "Ask me anything..." placeholder that types out character by character. Visitors can type a question directly and press Enter to start a conversation.
Below the input, you can add quick action buttons — small pill-shaped shortcuts that visitors can tap instead of typing.
Each button has a type:
- Message — sends a pre-written message and opens the chat
- Link — opens an external URL in a new tab
- Form — opens a specific form within the widget
ACTIVE_CHAT
The Active Chat card only appears when the visitor has an ongoing conversation. It shows:
- The last message preview (text or "Attachment" for files)
- The agent's avatar and name (or "You" if the visitor sent the last message)
- A relative timestamp ("just now", "5 minutes ago")
- A pulsing red dot when there are unread messages
Clicking the card takes the visitor straight back to the chat.
HELP (Knowledge Base Articles)
The HELP card displays a search bar and a list of knowledge base articles. Visitors can browse articles directly from the home screen or tap the search bar to jump to the full knowledge base.
Article selection:
- By default, the card shows the first 4 published articles from your knowledge base (sorted by weight)
- You can manually select specific articles in the dashboard to curate what appears
Clicking an article opens it in the widget's knowledge base view.
NEWS
The NEWS card displays recent news articles as rich preview cards with optional hero images, a title, and a content snippet.
Article selection:
- By default, the card shows the 2 most recent news articles
- You can manually select specific news articles in the dashboard
Clicking a news card opens the full article in the widget's news section.
MESSAGE
A simple card with a title and description that opens the chat when clicked. Use it as a direct "talk to us" call-to-action.
Default text:
- Title: "Send us a message"
- Description: "We typically reply in under 5 minutes."
The card shows a chat bubble icon that transitions to a chevron on hover.
LINK
An external link card with a title and description. Clicking it opens the URL in a new browser tab.
Use this for linking to external resources like documentation, your main website, booking pages, or anything outside the widget.
The card shows a link icon that transitions to a chevron on hover.
FORM
A card that opens a specific form when clicked. You can link it to any form you've created in your dashboard — bug reports, feature requests, contact forms, surveys, and more.
Form icon options:
| Icon | Use Case |
|---|---|
| Document (default) | General forms |
| Bug | Bug reports |
| Map | Location or roadmap feedback |
| Light bulb | Feature requests, ideas |
The icon is configurable per card in the dashboard settings.
Card Styling
All cards share a consistent visual style:
- Semi-transparent background using your Dimmed Background color
- Subtle border using your Decoration color
- Rounded corners and a soft shadow
- Hover effect that lifts the card slightly upward
- Icon animation on hover — the card's icon smoothly swaps to a chevron arrow
Adding and Reordering Cards
Open your widget settings
Go to Settings → Widget → Home in your dashboard.
Add a card
Click Add Card and select a card type from the dropdown. Configure its title, description, and type-specific options.
Reorder cards
Drag and drop cards to change their order. The top-to-bottom order in the settings is the exact order visitors see on the home screen.
Remove a card
Click the delete button on any card to remove it from the home screen.
Default Cards
When you create a new widget, it comes pre-configured with these cards (when applicable):
- HELP — if your workspace has a knowledge base
- MESSAGE — "Send us a message"
- FORM (Bug Report) — if a bug report form exists
- FORM (Feature Request) — if a feature request form exists
You can freely modify, reorder, or remove any of these defaults.