Filter My Blog logoFilter My Blog
Browse documentation

Sidebar and dropdown layouts

Updated

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.

LookWhat readers seePlan
Stacked pillsYour tags as pills, one per lineEvery plan
Checkbox or radio listA list with a checkbox or radio mark beside each tagPlus and Pro
AccordionThe list inside a section readers can open and close, with a headingPlus 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.

LookWhat readers seePlan
Simple menuA "Filter by topic" button that opens the tag listEvery plan
ChecklistThe same menu with a mark beside each tag, so readers see what they pickedPlus 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.

Loading search index
↑ ↓ to navigate↵ to selectEsc to close