Sidebar and dropdown layouts
Besides the grid and the scrolling row, the filter can sit in a sidebar column or behind a dropdown. Choose the layout in step 1 of the Design page, "How readers filter." Every look uses the colours, shape and type you already set, and every tag is still a real link, so filtering works even with JavaScript turned off.
Sidebar looks
| Look | What readers see | Plan |
|---|---|---|
| Stacked pills | Your tags as pills, one per line | Every plan |
| Checkbox or radio list | A list with a checkbox or radio mark beside each tag | Plus and Pro |
| Accordion | The list inside a section readers can open and close, with a heading | Plus and Pro |
Checkboxes tell readers that tags combine, so they need multi-select. With multi-select off, the list shows radio marks. The accordion's heading is the block's Heading setting in the theme editor, or "Topics" in the reader's language if you leave it empty. If you start the accordion closed, it opens by itself on a page where a tag is selected, so readers can always see what they are filtering by.
Dropdown looks
| Look | What readers see | Plan |
|---|---|---|
| Simple menu | A "Filter by topic" button that opens the tag list | Every plan |
| Checklist | The same menu with a mark beside each tag, so readers see what they picked | Plus and Pro |
The button always says what is selected, so readers don't have to open it to find out: the tag's name when one is chosen, "Recipes, Vegan" for two, and "Recipes +2" for more. With multi-select on, the chosen tags also appear under the button as small chips, each with an × that removes it, and the menu ends with Clear filters and Done.
The dropdown closes when readers click elsewhere, tab away from it, press Escape or press Done. The Alignment setting moves the button to the left, centre or right.
Placing the filter beside your articles
Open the theme editor, select the Blog tag filter block and use the Placement settings:
- Position: where you placed it, left of the articles, or right of the articles.
- Sidebar width: from 180 to 360 pixels.
- Stay in view while scrolling: keeps the sidebar visible as readers scroll the articles.
- On phones: show the filter above the articles, or behind a "Filters" button. The button shows how many tags are selected, for example "Filters (2)".
Left and right work on any theme the app recognises the article grid of, including Dawn and Horizon. On Dawn, where the block sits in its own section, the filter is moved beside the articles when the page loads. On phones the filter always sits above the articles.
Note
Placement is a theme-editor setting, available on every plan. If your theme's article grid isn't recognised, the filter stays where you placed it. Add data-btf-grid to your grid's element to opt in.