Card (ALPHA)
Responsive Widgets are in alpha and available by invitation only on Business and Enterprise plans. Behavior and properties may change. To request access, open a support ticket and name the feature Responsive Widgets (ALPHA).
The Card widget is a container. You drop other widgets into its body. It can also show an image at the top, a header row with an avatar, title, and subtitle, and a footer with up to two action buttons. Use it to group content about one item, such as a customer, product, or task.
A new Card starts with every extra part turned off. It is just a surface with an empty body. Turn on the parts you need in the property pane.
Widget type: WDS_CARD_WIDGET

Card layout
From top to bottom, a card shows:
- Media header: an image band. Shows when Show media header is on.
- Header row: avatar, title, and subtitle. Shows when Show header is on.
- Body: the widgets you drop into the card.
- Footer: the secondary and primary action buttons. Shows when Show footer is on and at least one action has a label.
If you delete the card's body from the entity explorer, the editor shows "This card's body was deleted. Undo to restore it." Use undo to bring it back.
Image URLs
The media image and the avatar image use the same URL checks as the Image widget. They allow:
- URLs on the same origin as your app, including relative paths.
- Absolute
https:URLs on any domain. - Base64 raster data URLs in this exact form:
data:image/<type>;base64,<data>, where<type>ispng,jpeg,jpg,gif,webp,avif, orbmp. The URL can be up to 4 MB long.
They reject http: URLs on another domain, SVG and other data URLs, javascript:, blob:, other schemes, and protocol-relative values such as //example.com/a.png. Images load with referrerPolicy="no-referrer".
Content properties
These properties appear in the Content tab of the property pane.
Media
Show media header boolean
Shows an image band above the card content. Default: off.
Image string
Sets the URL of the media image. Shows when Show media header is on. See Image URLs. If the URL is empty, rejected, or fails to load, the band shows the Alt text, or "No image" if alt text is empty.
Alt text string
Sets the text that screen readers read for the media image. The empty band also shows this text. Shows when Show media header is on.
Header
Show header boolean
Shows the avatar, title, and subtitle row above the body. Default: off.
Title string
Sets the card title. Long titles are cut to one line. Shows when Show header is on. Default: Card title.
Subtitle string
Sets a line of supporting text under the title. Long text is cut to one line. Shows when Show header is on.
Show avatar boolean
Shows an avatar at the start of the header row. Shows when Show header is on. Default: off.
The avatar shows the image first. If there is no image, or the image is rejected or fails to load, it shows initials. If there is no label for initials, it shows an icon.
Avatar image string
Sets the URL of the avatar image. See Image URLs. Shows when Show header and Show avatar are on.
Avatar label string
Sets the avatar's accessible name and the source of its initials. If empty, the avatar uses the title. Shows when Show header and Show avatar are on.
Footer
Show footer boolean
Shows the footer action row below the body. Default: off.
Primary action label string
Sets the label of the primary button. This is a filled button that comes after the secondary button. Leave it empty to hide the button. Shows when Show footer is on. Default: Confirm.
Secondary action label string
Sets the label of the secondary button. This is an outlined button that comes before the primary button. Leave it empty to hide the button. Shows when Show footer is on.
General
Visible boolean
Controls whether the widget is visible. Default: on.
Loading boolean
Shows a skeleton over the card while on. The card content stays in place under the skeleton, so the widgets inside keep their state. While loading, clicking the card does nothing. Default: off.
The card also shows the skeleton on its own while a query it depends on is running.
Example:
{{Query1.isLoading}}
Animate loading boolean
Controls the loading animation of the widget. Default: on.
Events
See Events.
Style properties
These properties appear in the Style tab of the property pane.