Troubleshooting

Use this guide when XpressPurge does not behave as expected.

If the browser says it cannot find manifest.json, you selected the wrong folder.

For Chromium development builds, load the dist folder directly.

The correct folder contains:

• manifest.json
• popup.html
• options.html
• background.js
• content.js
• icons
• assets

Check:

1. XpressPurge is installed and enabled.
2. Filtering is On in the popup or Options header.
3. You are on https://x.com/home or another supported X page.
4. The rule is enabled.
5. The preset containing the rule is active, or the rule is global.
6. The rule is not Pro-locked on the Free plan.
7. The value actually appears in the visible post.
8. Refresh the X page after updating the extension build.

Rules normally update without reloading X because XpressPurge listens for storage changes. If you reloaded the extension itself, refresh X because Chrome invalidates the old content-script context.

Chrome can show Extension context invalidated after an extension reload.

This usually means the X page still has an old content script from before the extension was reloaded.

Fix:

1. Go to the X tab.
2. Refresh the page.
3. If needed, close and reopen the tab.

This error is usually not caused by XpressPurge rules themselves.

Try:

1. Confirm Filtering is on.
2. Refresh X.
3. Scroll the feed so new posts are mounted.
4. Check whether X changed its layout.
5. Download diagnostics from Options > Help and send them to support.

XpressPurge relies on X page structure. If X changes selectors, a compatibility update may be needed.

Hidden counts increase when active Hide rules match visible posts.

They may stay at zero if:

• no Hide rules matched yet;
• only Boost rules matched;
• rules are disabled;
• matching rules are assigned to inactive presets;
• Filtering is off;
• the rule is Pro-only and you are on Free;
• the X page has not been refreshed after an extension reload.

Show-only requires:

• Pro access;
• Show-only mode turned on;
• at least one active Show-only rule;
• matching visible posts.

If Show-only mode is off, Show-only rules do not constrain the feed.

Boost should visually highlight matching posts. If it appears and disappears:

1. Confirm the Boost rule is enabled.
2. Confirm the rule is available on your current plan.
3. Confirm the preset containing the rule is active.
4. Refresh X.
5. Download diagnostics if the issue continues.

Boost does not move posts higher in the feed. It only changes the visual styling of matching posts.

The popup is designed to stay compact.

If you have many rules or presets:

• click Rules in the popup to search rules;
• click Presets in the popup to search presets;
• use Options for full editing.

Analytics require Pro and local hidden-post events.

Try:

1. Open X.
2. Confirm Filtering is on.
3. Enable a Hide rule.
4. Scroll the feed.
5. Open Options > Analytics.
6. Click Refresh.

Analytics do not backfill posts you saw before XpressPurge hid anything.

Check:

1. The code was copied from your XpressPurge account page.
2. The code has not expired.
3. The code has not already been used.
4. You are connected to the internet.
5. Your device limit has not been reached.

If you reached the device limit, revoke an old device before activating a new one.

Check:

1. You have Pro.
2. Browser sync is enabled in Options > Sync.
3. You are signed into your browser account.
4. Browser extension sync is enabled in your browser settings.
5. Click Sync now.

Remember that browser sync covers rules, presets, active presets, filtering state, hide behavior, and Show-only mode. It does not sync Smart Rules feed history, hidden-log previews, or analytics.

Browser sync depends on your browser provider.

Import only supports valid XpressPurge export JSON files.

Try:

1. Confirm the file is a .json file.
2. Confirm it was exported from XpressPurge.
3. Do not edit the JSON by hand unless you know the schema.

Imported files cannot activate Pro.

Go to Options > Help > Download Diagnostics.

If diagnostics are disabled:

1. Open Options > Privacy.
2. Turn on Allow diagnostics export.
3. Return to Help.
4. Download diagnostics.

Send diagnostics only to official support channels.