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

Where the app's tag list comes from, and how often it's refreshed.

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, right in the filter bar.

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

How to disable the filter on one blog without affecting the others.

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

The measurements that control a tag pill's size, spacing and text.

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 leading All pill does and when it's automatically hidden.

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

Letting readers combine several tags at once, without a page reload.

Analyticspro

Tag analytics

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

Analyticspro

Search analytics

What readers searched for, including the searches that found nothing.

Analytics

What we collect

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

Plans & billing

Plans compared

What Free, Plus and Pro each include, side by side.

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

Setting the language the app's own admin interface is shown in.

Account

Uninstalling and your data

What happens, and what doesn't, when you uninstall the app.

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

The checklist for when the bar doesn't appear on your blog at all.

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

What Dawn, Horizon and other themes each support, and why it differs.

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.