Help Center

Menu

The information on this page relates to beta testing within the DXP

This documentation includes information for selected beta testers within the DXP. DO NOT use this unless you have been instructed to do so.

Card listing

Use the card listing component to display a set of cards on your page.

Add the component to your page

When you are editing your page using page-builder:

  1. Add a component to your page by clicking the widgets Add component button or by adding a content block (by clicking the add_circle button) then clicking the add component button.

  2. Locate the card listing component within the component browser and then click the Select button.

    card listing component select

  3. This will add the card listing component to your page.

Configure the card listing component

card listing fields

  1. The add_circle button allows you to add additional cards. When the component loads you will have an unpopulated card that you can fill in . This is covered in the Card configurations section.

  2. This setting defines the maximum number of cards that will be displayed in a row when viewing your page in a desktop browser.

  3. This allows you to choose the heading level for the card title.

  4. This applies a highlighting style to the first card.

  5. (Optional) This allows you to add a unique ID into the HTML markup to the instance of the component so that you can add custom styling and functionality using CSS and javascript respectively.

  6. (Optional) This allows you to add a class into the HTML markup to the instance of the component so that you can add custom styling and functionality using CSS and javascript respectively.

Card configurations

This only applies to cards that you have manually added.

The following options can be used to configure each card:

card listing card item fields

  1. (Optional) Choose an image that you have already uploaded to the CMS to display as a thumbnail for the card.

  2. Enter the card’s title.

  3. (Optional) This field allows you to provide some descriptive text for your card.

  4. (optional) Allows you to add categories for your card by clicking the add_circle button. A field presents, into which you can enter a category label. You can also add additional categories and reorder the category list.

  5. This specifies if you are linking to another page in the CMS or an external, user-specified link. Depending on what link type you select you will see a combination of the following fields.

    Matrix asset

    This is displayed for Matrix asset picker links and allows you to choose the CMS page to which your card links.

    Text

    This is displayed for user-specified links and defines the link text.

    URL

    This is displayed for user-specified links and defines the link URL.

    Open link

    This controls how the link is opened when you click it. For example, open on a new page.