Promo banner module

Article
08/12/2022

This article covers promo banner modules and describes how to add them to site pages in Microsoft Dynamics 365 Commerce.

Promo banner modules are used to show inline informational messages on a page. They can be used to show site-wide promotions that appear on all pages of an e-Commerce site.

Promo banner modules support a text message and a link. If multiple messages are added to a promo banner module, it becomes a rotating carousel banner that lets customers cycle through all the messages.

Promo banner modules are driven by data from the content management system (CMS) and can be put on any page.

Promo banners can be used in the site header to show site-wide promotions or messages, as in the following examples.

"Annual sale ends in 10 days"

"Save big with back to school sale. Shop Now."

"Shop for Thanksgiving SALE!"

The following image shows an example of a promo banner.

Example of a promo banner module.

Property name	Value	Description
Banner messages	Text and links	An array of text and links.
Autoplay	True or False	A value that indicates whether messages are automatically cycled through, if multiple messages are configured.
Slide transition interval	A number of milliseconds (ms)	The interval that is used to cycle through messages.
Allow dismiss	True or False	If the value is set to True, customers can dismiss the alert.
Show carousel flipper	True or False	A value that indicates whether the carousel flippers should be shown, so that customers can manually cycle through multiple banner items.
Text alignment	Right, Left, or Center	The text alignment in the promo banner module.
Link	A URL	The URL for an optional link.
Text alignment	Right, Left, or Center	This property is available as a theme extension in the Adventure Works theme. It lets a user set the text alignment in the promo banner.

Important

The Adventure Works theme is available as of the Dynamics 365 Commerce version 10.0.20 release.

To add a promo banner module to a page and set the required properties, follow these steps.

Go to Templates, and select New to create a new template.
In the New template dialog box, under Template Name, enter Promo banner template, and then select OK.
Under Page Outline, add a Default page module to the Body slot.
Select Finish editing to check in the template, and then select Publish to publish it.
Use the template that you just created to create a page that is named Promo banner page.
In the Main slot of the new page, add a container module.
In the pane on the right, set the Width value to Fill Container.
Under Page Outline, add a promo banner module to the container module.
In the settings for the banner module, add one or more banner messages. Each message can have text together with a link. You can edit the other properties to customize the module further.
Select Save, and then select Preview to preview the page. At the top of the page, you should see an alert that shows the text that you added.
Select Finish editing to check in the page, and then select Publish to publish it.