Configurable Cards feature configuration

  • Release version: Washingtondc
  • Updated February 1, 2024
  • 4 minutes to read
    • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of Configurable Cards Feature Configuration

    The Configurable Cards feature allows you to enhance Engagement Messenger by adding and customizing features that are not available by default. This functionality supports various display options for feature cards, enabling tailored user experiences on the messenger's home page.

    Show full answer Show less

    Key Features

    • Display Options: Choose between displaying a feature card as an image or as a title with a subtitle.
    • Image Requirements: Supported formats are .jpg, .png, .bmp, and .gif, with specific dimension constraints (120x370px to 250x370px).
    • Page Type: Configure the page that opens upon clicking a feature card, either a catalog item or a portal page.
    • User Access Controls: Enable features for both unauthenticated (guest) and authenticated users, respecting access permissions defined for the portal or catalog item.
    • Related Website Links: Add up to five external links with optional images to the messenger's home page.
    • Record Display Options: Choose how to display records from a selected table, either as links or cards, and set conditions for which records appear.
    • Data Access for Guests: Control guest user access to specific tables in Engagement Messenger.

    Key Outcomes

    Implementing the Configurable Cards feature enables ServiceNow customers to create a more engaging and personalized experience in Engagement Messenger. This customization helps improve user interaction, facilitates access to important information, and ensures that the displayed content aligns with user permissions and needs.

    The Configurable Cards feature enables you to add and customize the features in Engagement Messenger that aren’t available by default.

    Table 1. Show a portal page or catalog item configuration form
    Field Description
    Choose how to display the card The type of display for the feature card on the messenger's home page. The available options are:
    • Use an image in a card: Shows a feature card as a clickable image.
    • Use a title and subtitle in a card: Shows a title and subtitle text as a display feature card
    Image An image that appears as a feature card on the messenger's home page and has a portal or catalog link embedded in it.
    The requirements for using images are:
    • Supported formats are .jpg, .png, .bmp, and .gif.
    • Dimensions are a minimum of 120x370px and a maximum of 250x370px.
    Note:
    This field appears only when Use an image in a card is selected from the Choose how to display the card field.
    Use a title and subtitle in a card
    • Title text: Title of the feature widget in the messenger.
    • Subtitle text: Description for the feature widget in the messenger.
    Note:
    This field appears only when Use a title and subtitle in a card is selected from the Choose how to display the card field.
    Page type The type of page that opens when the feature card is clicked.
    • Catalog Item: The catalog item that opens within the messenger when the user clicks on the feature card.
    • Portal Page: The portal page that opens within the messenger when the user clicks on the feature card. You can configure additional parameters to load specific content from the portal page. For more information about embedding portal pages on Engagement Messenger, see Requirements for embedding portal pages in Engagement Messenger.
    Enable for unauthenticated users Option for enabling this feature for guest users who visit the website that hosts the messenger.
    Enable for authenticated users Option for enabling this feature for users who sign in to the website that hosts the messenger.
    Note:
    Engagement Messenger honors access permissions defined for the portal page or catalog item. If the users do not have access, the feature card will not appear on the messenger.
    Figure 1. Use an image in a card
    Configurable cards displaying a list of features you can customize. In this example, the portal page displays an image as a card on the Engagement Messenger home page.
    Figure 2. Use title and subtitle in a card
    Configurable cards displaying a list of features you can customize. In this example, the portal page displays a title and subtitle as a card on the Engagement Messenger home page.
    Table 2. Show links to related websites configuration form
    Field Description
    Title text Title of the feature card in the messenger.
    Show an image for each link Option to display an image along with a link on the messenger's home page.
    Add up to five links Displays external website links on the messenger’s home page.
    Note:
    You can add a maximum of five links.
    Enable for unauthenticated users Option for enabling this feature for guest users who visit the website that hosts the messenger.
    Enable for authenticated users Option for enabling this feature for users who sign in to the website that hosts the messenger.
    Figure 3. Featured links
    Configurable cards displaying a list of features you can customize. In this example, embedded links are added to the Engagement Messenger home page.
    Table 3. Show records from any table form fields
    Field Description
    Choose a way to display records Determines the appearance of records on the messenger.
    • Each record displays as a link: Shows a title and list of records from the selected table on the messenger's home page. It displays up to five records on the messenger home screen.
    • Each record displays as a card: Shows a feature card through which users can access data from the selected table.
    Enable for unauthenticated users Option for enabling this feature for guest users who visit the website that hosts the messenger.
    Enable for authenticated users Option for enabling this feature for users who sign in to the website that hosts the messenger.
    Homepage
    Title text Title of the feature card displayed in the messenger.
    Subtitle text Description for the feature card displayed in the messenger.
    Display of records
    Choose table

    Determines the table that the card displays records from, either on your ServiceNow instance or from a remote third-party source.
    Number of records to show The total records to be shown as links on the messenger's home page. The maximum value is five.
    Note:
    This field is applicable only when Each record displays as a link is selected from the Choose a way to display records field.
    Page title
    Title of the messenger page that appears when a custom feature card is clicked.
    Note:
    This field is applicable only when Each record displays as a card is selected from the Choose a way to display records field.
    Display field The field from the selected table that you want to use as the primary display field.
    Details field The fields to display on the card that represent your data. You can select up to four detail fields.
    Note:
    Applicable only when Each record displays as a card is selected from the Choose a way to display records field.
    Portal page to open The portal page to display when the user selects any link or card.
    Condition for records Condition that restricts the records that appear in a list in the messenger.
    Note:
    • Engagement Messenger honors Access Control rules (ACLs) defined for any tables in your ServiceNow instance. If users don’t have access, the feature card doesn't appear on the messenger.
    • You can also enable the guest users to access data in Engagement Messenger from any specific table. For more information, see Associate the table with guest users in Engagement Messenger.
    Figure 4. Record displays as a link
    Configurable cards displaying a list of features you can customize. In this example, you can use multiple form fields to create and show record as link using Mobile phones card.
    Figure 5. Record displays as a card
    Configurable cards displaying a list of features you can customize. In this example, you can use multiple form fields to create and show record as card using Mobile phones card.