Documentation

Getting started

What Filter My Blog does

An overview of the tag filter bar, the admin that manages it, and how the two stay in sync.

Getting started

Installing the app

How installation works, what permissions it asks for, and what happens the first time you open it.

Getting started

The setup wizard

What each of the five setup steps does, and what happens if you skip one.

Getting started

Add the filter to your theme

Step-by-step instructions for placing the tag filter block on your blog, and what changes depending on your theme.

Getting started

Quickstart

The shortest path from installing the app to a live filter bar on your blog.

Tags

How tags are found

Tags come from your published articles, found by a crawl that runs nightly, right after install, and when you click Refresh.

Tags

Showing, hiding and renaming tags

Choose which tags appear in the filter bar, and change how any of them are displayed.

Tags

Tag order

The four ways tags can be ordered in the filter bar, and which plan each needs.

Tagsplus

Article count badges

Show how many articles carry each tag, as in "Recipes (12)". Counts come from a nightly crawl, not live. Plus plan.

Tags

Tag limits

How many tags the free plan shows per blog, and what happens to the rest.

Blogs

Managing multiple blogs

How the Blogs page works, and what changes when you have more than one blog.

Blogs

Turning off a blog's filter

Switch the tag filter off on one Shopify blog without editing the theme. Its tag visibility, order and renames are kept.

Design

Style presets

The eight starting points for the filter bar's look, and how they relate to custom styling.

Design

Colours

The eight colour values that make up the filter bar's appearance, and how they're grouped.

Design

Shape and type

Corner radius, font size, padding, gap and weight for each tag pill, the range each accepts, and the uppercase switch.

Design

Layout and alignment

Choosing between a wrapping grid and a horizontal scroll, and how alignment works.

Design

The "All" pill and clear control

What the All pill does, how to turn it off, and why multi-select swaps it for a clear link once a tag is selected.

Design

The theme editor heading setting

The one setting available directly in the theme editor, rather than in the app.

Design

Matching your theme

A practical approach to styling the filter bar so it looks like part of your theme rather than an add-on.

Storefront behaviour

How filtering works on the storefront

Why every tag is a real link, and what changes on themes that support instant filtering.

Storefront behaviourplus

Wording and translations

How the bar's fixed text is translated by default, and how to override any of it.

Storefront behaviourplus

Blog search

A search box scoped to one blog, styled to match the filter bar, with results built from your theme's own article cards.

Storefront behaviourplus

Multi-select filtering

Let readers combine tags and see only articles carrying all of them. Instant on Horizon themes, a page load elsewhere. Plus plan.

Analyticspro

Tag analytics

Clicks, impressions and click-through rate for every tag, and how far back the data goes.

Analyticspro

Search analytics

Your blog search's top twenty terms and the searches that found nothing. Pro plan, recorded without identifying anyone.

Analytics

What we collect

The exact data behind tag and search analytics, and what's deliberately never recorded.

Plans & billing

Plans compared

Free, Plus and Pro side by side: tags per blog, ordering, counts, blog search, multi-select and analytics. Design is free.

Plans & billing

Upgrading and downgrading

What happens to your settings when you change plans, in either direction.

Plans & billing

Billing and trials

How charges work, where they appear, and how the trial period is handled.

Account

Admin language

Show the Filter My Blog admin in English, French, German, Spanish, Italian, Portuguese or Dutch. Your storefront is unaffected.

Account

Uninstalling and your data

Uninstalling deletes nothing at once, so a reinstall restores your settings. Shopify's scheduled erasure removes data later.

Account

Requesting your data

How to ask what's stored about your shop, or ask for it to be corrected or deleted.

Troubleshooting

The filter isn't showing up

A step-by-step checklist for when the filter bar doesn't appear on your Shopify blog: theme editor, visible tags, blog switch.

Troubleshooting

Changes aren't appearing on the storefront

What to check when a save in the admin doesn't seem to reach your live blog.

Troubleshooting

Tags or article counts look wrong

Why a tag or count might be missing, out of date, or higher than expected, and how to fix each case.

Troubleshootingplus

Multi-select isn't combining without a reload

Why multi-select might be falling back to normal page links on your theme.

Troubleshooting

Theme compatibility

Every feature works on every Shopify theme. What differs is whether filtering updates in place (Horizon) or reloads (Dawn).

Troubleshootingplus

Search returns nothing

Why the blog search box might not return results, and how to tell the difference between no matches and a setup problem.