When to use
- Page heroes: the first section of a page, carrying its H1. The banner at the top of every block page, including this one, is a Teaser.
- Promotional banners further down a page, pointing to a campaign or a next step.
- An image with a message, where the text sits on the image or directly below it.
Key decisions
- Heading level. Title is rich text, so choose the heading in the editor: H1 for a page hero, H2 or lower further down. A page has one H1.
- Asset Context. Inline Asset (text overlay), the default, puts the text over the image, and Height sets the size. Inline Asset (text below) stacks the text under the image, which then keeps the desktop and mobile aspect ratios. Background Image currently renders the same as text overlay.
- Legibility. Set Text Color to suit the image, and add an Overlay (Light, Dark or Gradient) when the image is busy. Check the text over the busiest part of the image, on desktop and on mobile.
- Mobile Background Image replaces the image on small screens. Its alt text falls back to the desktop alt.
- Video. Set Media Priority to Video to play the Background Video, muted and looping, with a pause button. The background image becomes its poster and fallback.
- Calls to action. Up to two. The primary CTA defaults to Primary Filled and the secondary to Primary Outlined; Appearance changes the type, padding, text size, icon and roundness.
- Disclaimer Text sits inside or outside the teaser, at the left or right. Use it for image credits or short qualifying text.
Examples
Text over the image
The default Asset Context, with center alignment, Medium height, Dark text and both calls to action.
Text below the image
Asset Context is Inline Asset (text below), with a 16:9 image on desktop and 4:3 on mobile, left alignment and subtext. Its one call to action overrides the Primary Filled default with Primary Outlined.
Dark overlay with a disclaimer
A Dark Overlay with Light text, aligned left and to the bottom, at Large height. The Disclaimer Text sits outside the teaser, at the right, and the call to action keeps the Primary Filled default.
All authoring options
| Tab | Field | Name | Values |
|---|---|---|---|
| General | ID | id | Text |
| General | Media Priority | mediaPriority | Image, Video |
| General | Background Image | backgroundImage | DAM asset |
| General | Background Image Alt | backgroundImageAlt | Text |
| General | Mobile Background Image | mobileBackgroundImage | DAM asset |
| General | Mobile Background Image Alt | mobileBackgroundImageAlt | Text |
| General | Background Video | backgroundVideo | DAM asset |
| General | Pretitle | pretitle | Rich text |
| General | Title | title | Rich text |
| General | Subtitle | subtitle | Rich text |
| General | Description | description | Rich text |
| General | Subtext | subtext | Rich text |
| General | Disclaimer Text | disclaimer | Rich text |
| Appearance | Asset Context | imageContext | Inline Asset (text below), Inline Asset (text overlay), Background Image |
| Appearance | Desktop Aspect Ratio — Width | desktopAspectRatioWidth | Number |
| Appearance | Desktop Aspect Ratio — Height | desktopAspectRatioHeight | Number |
| Appearance | Mobile Aspect Ratio — Width | mobileAspectRatioWidth | Number |
| Appearance | Mobile Aspect Ratio — Height | mobileAspectRatioHeight | Number |
| Appearance | Disclaimer Position | classes_disclaimerPosition | Inside Teaser - Left, Inside Teaser - Right, Outside Teaser - Left, Outside Teaser - Right |
| Appearance | Content Alignment | classes_teaserAlign | Left, Center, Right |
| Appearance | Vertical Alignment | classes_teaserValign | Top, Middle, Bottom |
| Appearance | Height | classes_teaserHeight | Auto, Small, Medium, Large, Full Viewport |
| Appearance | Text Color | classes_teaserTextColor | Default, Light, Dark |
| Appearance | Overlay | classes_teaserOverlay | None, Light, Dark, Gradient |
| Primary CTA | Primary CTA Link | primaryCtaLink | Page path |
| Primary CTA | Primary CTA Text | primaryCtaContent | Rich text |
| Primary CTA | Primary CTA Icon | primaryCtaIcon | DAM asset |
| Primary CTA | Primary CTA Icon Alt | primaryCtaIconAlt | Text |
| Primary CTA | Primary CTA Title (For Accessibility) | primaryCtaA11yContent | Text |
| Primary CTA | Is Primary CTA Disabled | primaryCtaDisabled | On / off |
| Primary CTA | Primary CTA Appearance | primaryCtaClasses | CTA Type: Primary Filled, Primary Outlined, Secondary Filled, Secondary Outlined, Link; CTA Padding: Default, Small, Large; CTA Text Size: Default, Small, Large; CTA Icon Size: Default, Small, Large; CTA Icon Spacing: Default, Small, Large; CTA Icon Position: Left, Right; CTA Roundness: Default, None, Rounded, Curved |
| Secondary CTA | Secondary CTA Link | secondaryCtaLink | Page path |
| Secondary CTA | Secondary CTA Text | secondaryCtaContent | Rich text |
| Secondary CTA | Secondary CTA Icon | secondaryCtaIcon | DAM asset |
| Secondary CTA | Secondary CTA Icon Alt | secondaryCtaIconAlt | Text |
| Secondary CTA | Secondary CTA Title (For Accessibility) | secondaryCtaA11yContent | Text |
| Secondary CTA | Is Secondary CTA Disabled | secondaryCtaDisabled | On / off |
| Secondary CTA | Secondary CTA Appearance | secondaryCtaClasses | CTA Type: Primary Filled, Primary Outlined, Secondary Filled, Secondary Outlined, Link; CTA Padding: Default, Small, Large; CTA Text Size: Default, Small, Large; CTA Icon Size: Default, Small, Large; CTA Icon Spacing: Default, Small, Large; CTA Icon Position: Left, Right; CTA Roundness: Default, None, Rounded, Curved |
| Analytics | Track Inview | classes_track-inview | On / off |
| Analytics | Track Primary CTA Click | classes_track-primary-cta-click | On / off |
| Analytics | Primary CTA Click Meta | primaryCtaClickMeta | Text |
| Analytics | Track Secondary CTA Click | classes_track-secondary-cta-click | On / off |
| Analytics | Secondary CTA Click Meta | secondaryCtaClickMeta | Text |
| Analytics | Track Description Link Click | classes_track-description-link-click | On / off |
| Analytics | Meta for Links in Description | descriptionLinkMeta | Text |
| Analytics | Track Subtext Link Click | classes_track-subtext-link-click | On / off |
| Analytics | Meta for Links in Subtext | subtextLinkMeta | Text |
| Analytics | Events/Analytics Meta | meta | Text |
Each analytics toggle adds a class and creates no row. The click-meta fields take a JSON object; the link-meta fields take one JSON object per link, in order, with a hyphen (-) to skip a link. Events emitted:
emu-teaser:inview
emu-teaser:primary-cta:click
emu-teaser:secondary-cta:click
emu-teaser:inner-link:click