Promotion

Promotions are timed pieces of content that allow content editors the flexibility to create a single item that can be placed in multiple locations on the site, without having to duplicate or manage content in multiple locations. This content type is typically not displayed on its own page.

Fields

NameMachine nameField typeRequired?Description
TitletitleText (plain)YesThe main title of the promotion.
Subtitlefield_subtitleText (plain)NoA secondary title or short description displayed below the main title.
CTA / linkfield_linkLinkNoA call-to-action link that directs users to a specific page or external resource.
Descriptionfield_promo_descriptionText (formatted, long)NoA longer description providing more details about the promotion. This field supports rich text formatting (e.g., bold, italics, lists, links).
Imagefield_promo_mediaEntity referenceYesAn image associated with the promotion. This is an entity reference to a media item.
Pagesfield_promo_visibility_pagesText (plain, long)NoA list of internal page paths where the promotion should be displayed. Use relative paths. One path per line. Use <front> for the front page.
Promotion Categoryfield_promo_categoryEntity referenceNoA category that classifies the promotion (e.g., “New Product,” “Sale,” “Event”). This is an entity reference to a taxonomy term.
Promotion Priorityfield_promo_priorityList (text)YesDetermines the order in which promotions are displayed. Options might include “High,” “Medium,” and “Low.”
Promotion visibility statefield_promo_visibility_stateList (text)YesControls whether the promotion is visible or hidden. Options may include “Published”, “Unpublished”.

URL pattern

Promotions are generally embedded within other pages and do not have their own dedicated URL. Therefore, no URL pattern is defined for this content type.

Last modified March 11, 2025: fix: markdown ai typo (7c7c61db)