Troubleshooting

Work through these checks in order. Most problems are a toggle, a scope, or a page the browser doesn't allow extensions on.

Replacement isn't working

  1. Is the extension enabled in the popup (header switch)?
  2. Is the site disabled for the extension? Re-enable it from the popup.
  3. Is the rule's collection enabled? Disabled collections show a warning in the editor.
  4. Is the rule itself disabled?
  5. Does the rule scope allow this site? An empty site list means all sites.
  6. For RegEx rules: is the pattern valid? The editor shows syntax errors inline.
  7. Reload the tab after changing rules or toggles.

It worked, then stopped

  • Single-page apps re-render without reloading. The extension watches for that, but a full tab reload re-syncs everything.
  • Check whether the site was disabled accidentally (per-site toggle).
  • Check whether a recent rule edit introduced an invalid pattern. Bad rules are skipped, but good ones keep working.

Typing feels broken or the cursor jumps

  • Update to the latest version. Cursor preservation in inputs and editors is actively maintained.
  • If a specific site misbehaves (for example a chat box), exclude it with a site scope or an ignore selector for that rule.
  • IME/compose input (e.g. CJK keyboards) is left alone until you confirm the composition.

A video player or complex page breaks

Some players rebuild their interface constantly, which fights live replacement. Disable the extension for that site from the popup. Playback and replacement don't mix there.

Import fails

  • The file must be JSON: a flat rule array or a collections array.
  • Every rule needs a find (from or fromRegexStr) and a to.
  • One invalid entry rejects the whole file. The error message says which index failed. Fix it and retry.
  • If the file picker seemed to vanish instantly: the popup closes when it loses focus. Reopen the popup and try again.

A huge page (mail, docs) feels slow

Very large documents mean more text to scan. Reducing active rules or scoping them to the sites you need helps. If a page is unusable, disable the extension for that host.

Still stuck?

Contact support with your extension version (popup footer), the site URL, and what you expected. Never include passwords or private text.