Promo module

A promo promotes an asset and appears in a containing page. Promo modules can be used as leads for articles, sections, tags, homepages, and more.

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

Note

This topic describes how to create a shared promo that you can use in multiple pages. (If you want to create a one-off promo, see Creating a one-off module.)

To create a promo:

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

Promo module fields

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

Main

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.
Item	Select one of the following: Internal—Promo links to an asset in Brightspot. No Link—Promo does not contain a link. External—Promo links to a web page outside your site. For Internal and External selections, you can set whether the URL opens in the same window or in a new window.
Title	This field defaults first to the internal asset's Promo Title (if available), and next to the asset's Title or Headline field. This title appears in the shared promo. You can modify the Title if necessary.
Description	This field defaults first to the internal asset's Promo Description (if available), and next to the asset's Description field. You can modify the Description if necessary.
Image Override	This field defaults to the internal asset's Lead image (if any). This image appears in the shared promo. You can select a different image if necessary.
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	Descripton
Category	Enter text to override what appears as the eyebrow text when this promo appears on a page.
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

Page Promo Module Styles

Advanced

Field	Description
Hide Description	Toggle on to hide the description of the asset 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 Image	Toggle on to hide the image included on the asset contained in the module.
Hide Publish Date	Toggle on to hide the publish date of the assets included in the module.
Hide Category	Toggle on to hide the category of the asset included in the module.
Hide Author	Toggle on to hide the author of the asset included in the module.

Page Promo Module 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.
Promo Title Size	Overrides the default text size of the promo title as specified in your theme's CSS file.
Promo Description Size	Overrides the default text size of the promo description as specified in your theme's CSS file.

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.

Promo embeds

You can embed an asset's promo into the rich-text editor. The promo contains the title, description, and image from the corresponding asset's promo; you can customize those three elements inside the promo module.

To embed a promo:

1. From the rich-text editor's toolbar, select > Promo.
2. Using the following table as a reference, complete the fields as needed.
3. Click Save & Close.

Field	Description
Promo	Select Inline or Shared. See Inline vs. shared enhancements.
Item	Retain Internal, then search for and select the person to promote. Under Target, select whether you want the link to open in the same tab or a new tab.
Anchor	Select an anchor, which will route site visitors to a specific area within the promoted asset.
Target	Select whether you want the link to open in the same tab or a new tab.
Title	Enter a title.
Description	Describe the list.
Image Override	Select an image to override the default image of the promoted asset.
Call To Action Button Text	Enter text to appear on the call-to-action button.

Page Promo Enhancement Styles

Field	Description
Template	Select one of the available templates for laying out this enhancement.
Preset	Select a style preset for this enhancement.
Choose Enhancement Alignment	Select an alignment for this list.
Promo Title Size	Select the promo title size.
Promo Description Size	Select the promo description size.
Text Alignment	Select an alignment for the text of this product promo.
Choose a Background Color	Select a color for the background of the product promo.
Use Text Colors	Select the color to use for text. Standard—Use the text color specified in the site's theme. Inverse—Use the inverse of the text color specified in the site's theme.
Module Padding Top	Select one of the options (None, Small, Medium, Large).
Module Padding Bottom	Select one of the options (None, Small, Medium, Large).