List module

List modules allow you to display promos of assets in a list. There are three main types of list modules:

• Basic list modules—A list of any type of asset promo, the titles and descriptions of which you cannot override.
• Advanced list modules—A list of specific types of asset promos, the titles and descriptions of which you can override.
• Dynamic list modules—A list of any type of asset promo, the contents of which are populated dynamically based on the settings you select.

For a wire frame example of what this content type can look like on your site, see List module design.

To create a list module:

1. In the header, click .
2. From the Create list, select List Module.
3. Using the following table as a reference, complete the fields as needed.
4. Complete your site's workflow and publish the list module.

List module fields

Click each tab below to see a description of the associated fields.

Main

Basic list module

Basic lists contain assets of any content type. The assets in the list do not change unless you explicitly change them.

A basic list renders promos of the list's underlying assets, and you cannot override the promos' text or image. (Changes to the assets' promos appear in the rendered basic list.) Advanced lists can also contain promos of the list's underlying assets, but you can override the promos' text and image.

Field	Description
Internal Name	Enter an internal name for this asset. Brightspot uses this name internally, such as in the search panel and recent activity widget. This name is not visible to visitors to your site.
Title	Enter a title for this asset. This title is visible to the visitors to your site.
Description	Enter a description that describes this asset. This description is visible to the visitors to your site.
Items	To add assets to the list, select Basic and then click .
Call To Action	Select None, Internal or External. None—No call to action button is displayed. Internal—A call to action button is displayed that links to an internal asset. External—A call to action button is displayed that links to an external URL. When setting up an internal or external call to action, you have the option to set how the link will behave. Select either Internal or External, then specify a target or, for internal links only, an anchor to which you link visitors. Each option also allows you to define Name and Value attributes, the latter of which appends an additional parameter to the URL (for example, if you input Brightspot Home Page. into the Value field, appends Title="Brightspot Home Page" to the URL of the external link specified in the call to action).
Call To Action Button Text	Enter text appearing on the call-to-action button. This text is visible to the visitors to your site.

f

Advanced list module

Advanced lists can contain ad modules, dynamic promos, HTML embed modules, iframe embed modules, or promos. The assets in the list do not change unless you explicitly change them.

If your advanced list includes promos, you can customize the promos' text and image. (Your customizations remain even if an asset's promo changes.) Basic lists also contain promos of the list's underlying assets, but you cannot customize the promos' text and image.

Field	Description
Internal Name	Enter an internal name for this asset. Brightspot uses this name internally, such as in the search panel and recent activity widget. This name is not visible to visitors to your site.
Title	Enter a title for this asset. This title is visible to the visitors to your site.
Description	Enter a description that describes this asset. This description is visible to the visitors to your site.
Items	To add assets to the list, select Advanced and then click .
Call To Action	Select None, Internal or External. None—No call to action button is displayed. Internal—A call to action button is displayed that links to an internal asset. External—A call to action button is displayed that links to an external URL. When setting up an internal or external call to action, you have the option to set how the link will behave. Select either Internal or External, then specify a target or, for internal links only, an anchor to which you link visitors. Each option also allows you to define Name and Value attributes, the latter of which appends an additional parameter to the URL (for example, if you input Brightspot Home Page. into the Value field, appends Title="Brightspot Home Page" to the URL of the external link specified in the call to action).
Call To Action Button Text	Enter text appearing on the call-to-action button. This text is visible to the visitors to your site.

Dynamic list module

Dynamic lists contain assets of any content type. The assets in the list change depending on the selection of sort and filtering criteria you configure. For details on these dynamic settings, see Understanding dynamic list settings.

Field	Description
Internal Name	Enter an internal name for this asset. Brightspot uses this name internally, such as in the search panel and recent activity widget. This name is not visible to visitors to your site.
Title	Enter a title for this asset. This title is visible to the visitors to your site.
Description	Enter a description that describes this asset. This description is visible to the visitors to your site.
Items	Click , and select Dynamic.
Types	Select the content types included in this list.
Sort	Select the sort order for this list.
Items per page	Enter the number of items displayed in each page. If the dynamic list has more items than this value, Brightspot displays next and previous links so the visitor can page through the list.
Filtering Rules	Select filtering criteria for this list. For information about the various filters, see Understanding dynamic list settings.
Pinned Items	Select assets that always appear first in this list. For information about pinning items, see Understanding dynamic list settings.
Call To Action	Select None, Internal or External. None—No call to action button is displayed. Internal—A call to action button is displayed that links to an internal asset. External—A call to action button is displayed that links to an external URL. When setting up an internal or external call to action, you have the option to set how the link will behave. Select either Internal or External, then specify a target or, for internal links only, an anchor to which you link visitors. Each option also allows you to define Name and Value attributes, the latter of which appends an additional parameter to the URL (for example, if you input Brightspot Home Page. into the Value field, appends Title="Brightspot Home Page" to the URL of the external link specified in the call to action).
Call To Action Button Text	Enter text appearing on the call-to-action button. This text is visible to the visitors to your site.

Related Content list module

Related Content list modules contain article assets that are related to the asset you specify.

Field	Description
Internal Name	Enter an internal name for this asset. Brightspot uses this name internally, such as in the search panel and recent activity widget. This name is not visible to visitors to your site.
Title	Enter a title for this asset. This title is visible to the visitors to your site.
Description	Enter a description that describes this asset. This description is visible to the visitors to your site.
Items	From the Items list, select Related Content.
Source	Select a source for the related content from one of the following options: Specify—Select the article which serves as the source of the related content. Toggle on Exclude Source to exclude the article you specify from the list of related content. None—There is no related content. Use Current—Uses the current asset as the source of the related content.
Call To Action	Select None, Internal or External. None—No call to action button is displayed. Internal—A call to action button is displayed that links to an internal asset. External—A call to action button is displayed that links to an external URL. When setting up an internal or external call to action, you have the option to set how the link will behave. Select either Internal or External, then specify a target or, for internal links only, an anchor to which you link visitors.
Call To Action Button Text	In the Call To Action Button Text, enter text appearing on the call-to-action button. This text is visible to the visitors to your site.

Overrides

Field	Description
Anchor	Modify the anchor to something that would make sense when appearing in an Anchor field's drop-down menu on another asset. This allows you to directly link to this module in another asset. Being specific makes it easier to identify in a list of other anchors.

Styles

Advanced

Field	Description
Hide Descriptions	Toggle on to hide the descriptions of the assets contained in the list module. For example, toggling on this setting displays the Headline of an article, but hides the Description of an article contained in the list module.
Hide Images	Toggle on to hide the images included on the assets contained in the list module.
Hide Publish Dates	Toggle on to hide the publish dates of the assets included in the list module.
Hide Categories	Toggle on to hide the categories of the assets included in the list module.
Hide Authors	Toggle on to hide the authors of the assets included in the list module.

Page List Styles

Field	Description
Template	Select the template of this module from the list of options. Templates are visual presentation presets that differ depending on the type of module.
Preset	Select one of the following: None—Applies styling from the site's theme. Custom—Opens a form to customize the site's theme for this asset. (Various)—Aside from None or Custom, there may be additional options in this list depending on the value selected in the Template field. If the selected template has presets, then those presets are able to be selected in this list and applied. For information about configuring template presets, see Creating a template preset.
List Title Size	Overrides the default text size of the list's Title as specified in your theme's CSS file.
List Description Size	Overrides the default text size of the list's Description as specified in your theme's CSS file.
Choose a Background Color	Enter the hexadecimal value of a background color for this module. For instance, entering #000888 provides a dark blue background.
Change Primary Text Color to Primary Inverse Text Color (Set in Theme Colors)	Toggle on to convert the primary color of the text in the module to the inverse color of the text set in the theme.
Module Padding Top	Overrides the default padding at the top of the module as specified in your theme's CSS file. You can choose from None, Small, Medium, or Large.
Module Padding Bottom	Overrides the default padding at the bottom of the module as specified in your theme's CSS file. You can choose from None, Small, Medium, or Large.

Page List AMP Styles

Field	Description
Template	Select the template of this module from the list of options. Templates are visual presentation presets that differ depending on the type of module.

Translations

Field	Description
Locale	Sets the content's locale. This setting can also be used to auto-localize content based on the users requested locale.