Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Insert a header card in a Static Choice or Dynamic Choice control

When you create a Virtual Agent topic, you can include images and YouTube videos on Static Choice and Dynamic Choice user input controls.

Before you begin

Role required: virtual_agent_admin or admin

Procedure

  1. Navigate to All > Conversational Interfaces > Virtual Agent > Designer and open a topic or create a new one.

  2. On the Flow tab, drag a Static Choice or a Dynamic Choice user input control onto the canvas.

  3. On the Properties sheet, go to Advanced (optional), and then expand the Header card section.

  4. Slide the Insert toggle switch to enable it.

Image omitted: va-insert-header-help-yes.png
Header card section of Dynamic Choice user input control, with Insert toggle and Would you like help radio button enabled.
  1. Under Would you like help?, select either Yes or No, I will use a script.

    • If you selected Yes, select Add card and complete the following form fields.
FieldDescription
Card typeType of header card:- Large image with text - Small image with text - Youtube Video Card The fields in the dialog box change according to your choice.
TitleImage or video title. You can enter it directly in the text field or use a data pill or script to provide the value.
Title LinkThe URL to use for the video title hyperlink. You can enter it directly in the text field or use a data pill or script to provide the value. If this field is empty, the title displays as plain text.This field is only available for the YouTube video card option.
DescriptionBrief description of the image or video.
Image URL LinkURL link for the image. You can enter it directly in the text field or use a data pill or script to provide the value. You can also select Upload Image to upload the image.This field is only available for the large and small image card options.
Image alt textAlternative, screen-readable text that describes the image. It’s used for accessibility programs.This field is only available for the large and small image card options.
Youtube Video IDThe alphanumeric string at the end of the YouTube URL. For example, in the URL `https://www.youtube.com/watch?v=AacDp2mUQ1I` the YouTube video ID is `AacDp2mUQ1I`.This field is only available for the YouTube video card option.
-   If you selected **No, I will use Script**, select **Add script** to input a script to display your desired media, following the example in the script dialog box.

    ```
    function() {
        /*
            var cardName = "Large image with text";
            var cardData = {
                title: 'Choose color',
                description: 'choose the right color of the flowers in the image',
                image: 'https://homepages.cae.wisc.edu/~ece533/images/tulips.png',
                imageAlt: 'Choose color'
            }
            var template = "";
            if (vaSystem.isAMBClient(vaContext.deviceType))
                template = vaSystem.fillTemplateFromData(cardName, JSON.stringify(cardData));
          return {
              cardTemplate: template,
              cardName: cardName,
              cardData: JSON.stringify(cardData),
              renderStyle: "card"
          };
        */
        }

    ```
  1. Select Save.

Parent Topic:Creating a Virtual Agent topic