All docs

Guides

Topic explorer

Build a browsable guide page from Topic and Entry blocks, with linkable topics and entries that open in a drawer.

The Topic explorer turns a page into a browsable guide, such as a fabric guide, a care guide or a guide to your product range. You build it entirely from blocks in the theme editor: Topic blocks for the main subjects, and Entry blocks for the items within each topic.

For a full list of settings, see the Topic explorer section reference.

How it works for shoppers

  • Topics show as a stepped stack of bands, with smaller topics in a row of cells under it.
  • One topic shows at a time. Selecting a topic opens it.
  • The page address follows the open topic, so you can copy the address and share a link that opens that topic directly.
  • Each topic lists its entries as cards. Selecting an entry opens it in a drawer, where shoppers can page through the other entries in that topic.

Set up the page

Propel includes a page template called page.topics with a Topic explorer already in place.

  1. In Shopify admin, go to Online Store > Pages and create or open a page.
  2. Under Theme template, choose topics and save.
  3. Go to Online Store > Themes > Customize and open that page.
  4. Select the Topic explorer section to edit it.

You can also add a Topic explorer section to another page template with Add section.

Section settings

SettingWhat it does
EyebrowA short line above the heading.
HeadingThe section heading. Default: Topics.
IntroductionText under the heading.
Use the heading as the page titleMakes the heading the page's H1.

If you turn on Use the heading as the page title, turn off Show page title in the Main page section so the page has only one main title. The topics template comes set up this way.

Topic block

SettingWhat it does
TitleShown in the topic stack and as the topic's heading.
TaglineA short line shown under the title in the stack, and next to the number above the topic heading.
NumberShown in the stack, for example 01. Leave blank to number topics in order.
Show asStacked band adds this topic to the stepped stack. Small cell places it in the row of smaller links under the stack.
IntroductionText at the top of the open topic.
Key pointsA short list, one point per line.
Open this topic firstShows this topic when the page loads. If several are turned on, the first one wins. A link to a specific topic overrides it.

Entry block

SettingWhat it does
TitleShown on the entry card and as the heading of the opened entry.
SummaryA short line on the entry card. It does not show in the opened entry.
ImageShown on the entry card and in the opened entry. Screen readers use the image's own alt text, set in Content > Files.
TextShown only when the entry is opened.
FactsOne fact per line, written as label: value, for example Fit: Close. Lines without a colon are skipped.
ProductAdds a shop link with the product's name and price at the end of the opened entry.

Put entries under the right topic

Entries belong to the Topic block above them. Every Entry block placed after a Topic block, up to the next Topic block, belongs to that topic. To move an entry to another topic, drag it below that topic in the block list.

A suggested order:

  1. Add a Topic block.
  2. Add its Entry blocks directly below it.
  3. Repeat for the next topic.

A Topic explorer section can hold up to 50 blocks in total, counting topics and entries.