Filters and rules

Create and manage your rules

Review, apply and undo custom blocking rules without confusing them with the blocking sources you added.

Quick answer

Use Your Rules for filter lines you write or receive from a trusted helper. Write one rule per line, choose Review changes, read the preview, and then choose Apply rules. Editing text or opening the preview alone does not save a change.

Make a backup before a large edit. A broad blocking or hiding rule can remove something a website needs.

Where to find it

Open Settings → Protection, turn on Advanced Settings, then open Your Rules. Added Blocking Sources manages the sources you added separately. Websites manages site pauses and exceptions separately.

What to do

  1. Keep a copy of your existing rules before editing.
  2. Add or change one line. For example, ||ads.example^ describes request blocking for a host and its subdomains. These example addresses are placeholders, not recommended live rules.
  3. To allow matching requests instead, the corresponding form is @@||ads.example^. For a site-scoped hide, news.example##.advertisement hides matching elements on that site.
  4. Choose Review changes. Read the valid and unsupported totals, where rules apply, and what exceptions allow.
  5. Check any browser-limit warning. Choose Apply rules only when the preview describes what you intend.
  6. Wait for the save result and reload the website you are checking.

A request exception allows matching requests; a cosmetic exception stops a matching hide. They do different jobs. The network and cosmetic references explain the supported forms.

What should happen

Shield shows a preview before applying changes. Unsupported lines are identified rather than silently reinterpreted as broader rules. Browser limits can leave some accepted request-blocking rules inactive, so read the save result as well as the preview.

A successful save confirms configuration. It does not establish that the rule matched a request or element on the page you are viewing.

Undo

Use Undo this change while it remains available on this Settings page. If you have already left, edit or remove the relevant line and review and apply again. Clear my rules removes the rules you wrote here after confirmation; blocking sources and paused sites stay the same.

If that does not work

Check the exact line number and message. Do not remove an unfamiliar modifier simply to make a copied rule pass: that can broaden its effect. Full syntax from other blockers is not interchangeable with Shield’s supported subset. Reload the website after correcting a rule.

Need more help? Contact support and share a report, or use the support contact details.

Still need help? Contact support