Skip to main content

Configuring Composer for Themes

To ensure a site works as expected with Themes, configure the following items in Composer settings.

Kickers/Labels

By default, the Overline Block displays the name of the content's section (for example, "News" or "Sports") and hyperlinks to that section's page. If the content is flagged as sponsored in Composer, then "Sponsored Content" will display. You may also configure a label in Composer settings to override these values at the story level: 

  1. Configure a Label Type named basic. The Overline Block displays the basic label if it’s present in a story.

  2. You can decide whether or not to Allow Free Entry of basic labels and/or create a Pick List of preconfigured options.

PageBuilder Preview URL

Set the Page Builder Preview URL to the following value: /pf/composer-preview/{_id}/?published=false&_ignoreCache=true&_website={canonical_website}

rId26.png

This pattern matches the Preview Unpublished Stories Resolver that you get out-of-the-box with Themes, so you should now be able to Use The Story Preview Button on stories within Composer.

Featured Media

Types that will display in the Featured Media tab while composing a story, are configurable within Composer settings. To ensure compatibility with Themes blocks:  

  1. Configure a Basic (media key: basic) featured media type, which allows:

    • Image

    • Gallery

    • Video

    • HTML

  2. Configure a Lead Art (media key: lead_art) featured media type, which allows:

    • Image

    • Gallery

    • Video

    • HTML

Media keys behavior

What appears on your site depends on the featured media keys published on the Composer story unless you override the media on the block in PageBuilder Editor. 

  • If you provide lead_art and basic media keys, stories with the lead art block display the lead_art media, and promo blocks display the basic media. 

  • If you provide only the lead_art media key, stories with the lead art block display the lead_art media, and promo blocks display the fallback image.

  • If you provide only the basic media key, stories with the lead art block and promo blocks display the basic media.

  • If you do not provide featured media, the fallback image will appear on promo blocks, and lead art will not display on the story. 

rId32.png