Complete user manual
Social Feed Purifier hides supported feed clutter locally on Facebook, Reddit, and LinkedIn. This manual explains what every popup control does, what each site-specific filter targets, and how to correct mistakes without sending feed content anywhere.
Use this flow after installing or updating the extension.
facebook.com, reddit.com, or linkedin.com.chrome.storage.local.Sponsored or Promoted post filtering is enabled by default. Broader filters such as suggested posts, NSFW posts, LinkedIn jobs, videos, external links, and navigation cleanup are opt-in.
The popup changes labels and panels based on the active tab.
Supported on www.facebook.com, web.facebook.com, and m.facebook.com.
Covers feed posts, sponsored modules, selected navigation clutter, and dedicated Reel pages.
Supported on www.reddit.com, new.reddit.com, and old.reddit.com.
Covers Promoted posts, feed recommendations, content tags, videos, and outbound links.
Supported on www.linkedin.com. Covers Promoted posts, display/right-rail ads, recommended people,
recommended jobs, network activity posts, videos, and outbound links.
Instagram support is not active in the current public build while its detector is redesigned. This manual still documents the paused Instagram controls so older development builds and stored settings are understandable.
These controls appear for supported sites unless a panel is explicitly site-specific.
| Item | What it means | Notes |
|---|---|---|
| Status text | Shows whether the active tab is Facebook, Reddit, LinkedIn, or unsupported. | If it says to open a supported site, reload the supported tab and reopen the popup. |
| Version badge | Shows the installed extension version. | Current release line is 1.4.85. |
| Total hidden | All-time hidden count stored in this browser. | Reset with Reset counters. |
| On page | Number of posts hidden on the active supported tab. | This changes as the feed mutates or as you scroll. |
| Suspicious | Posts detected as suspicious but not hidden automatically. | Use Review suspicious to inspect one of them. |
| Recommend Social Feed Purifier | Opens the public project website. | This is a normal browser tab link; it does not send feed data. |
| Control | Effect | Site behavior |
|---|---|---|
| Ads Only | Applies the safest cleanup profile for the active site. | Facebook Sponsored posts, Reddit Promoted posts, or LinkedIn Promoted posts stay enabled. Broader clutter filters stay off. |
| Clean Feed | Applies a stronger opt-in cleanup profile for the active site. | Enables common site-specific clutter filters. It does not change privacy behavior. |
| Reset | Returns the active site's settings to conservative defaults. | Also clears text rules and allow rules for Reddit and LinkedIn resets. |
| Scan now | Asks the active content script to rescan the current page. | If needed, the popup injects the matching local content script into the active supported tab. |
| Control | What it does | Use when |
|---|---|---|
| Hide automatically | Hides posts that meet the current hide decision. | Turn off if you want suspicious or matched posts to remain visible while tuning settings. |
| Show placeholders | Replaces hidden posts with a compact placeholder instead of removing all visible trace. | Use this while testing filters; turn it off when you want the cleanest feed. |
| Aggressive mode | Hides borderline suspicious posts sooner. | Useful if you prefer stronger cleanup and accept more false-positive risk. |
| Sponsored posts / Promoted posts | Enables the main ad/promoted post filter for the active site. | Shown as Sponsored posts on Facebook and as Promoted posts on Reddit and LinkedIn. |
| Right sponsored boxes (Facebook) | Hides sponsored modules in Facebook's right rail. | Facebook only. |
| Display/right rail ads (LinkedIn) | Hides LinkedIn display ad iframes, sponsored modules, and right-rail ad placements. | LinkedIn only. |
| Hide threshold | Numeric cutoff from 0 to 1 for the local classifier. |
Default is 0.7. Lower values hide more. Higher values hide less. |
| Field | What it does | Syntax |
|---|---|---|
| Hide posts containing | Hides posts whose text matches any line in this box. | Use one plain phrase or one regex per line. |
| Always allow if containing | Protects posts whose text matches any line in this box. | Allow rules win over hide rules and classifier decisions. |
| Plain phrase | Case-insensitive text match. | Example: webinar |
| Regex | JavaScript-style regex rule. | Example: /limited\\s+offer/i |
| Control | What it does | Result |
|---|---|---|
| Report missed post | Starts the on-page picker for a visible post that should have been hidden. | The clicked post is classified locally and the matching filter may be enabled locally. |
| Undo last hidden | Restores the most recently hidden post in the active tab. | Also saves feedback that the post should not have been hidden as an ad. |
| Review suspicious | Scrolls to a post that the detector considered suspicious but left visible. | If it should be hidden, use Report missed post. |
| Advanced corrections | Expands manual type selection and local data controls. | Useful when Auto-detect chooses the wrong missed-post type. |
| Force missed post type | Overrides Auto-detect for the next picker action. | Options change based on active site. |
| Export local data | Downloads a JSON file with settings, counters, local weights, and local samples. | For your own backup or debugging. |
| Reset learning | Clears local training samples and local classifier weight adjustments. | Does not uninstall the extension. |
| Reset counters | Clears local hidden, suspicious, false-positive, and user-marked counts. | Does not change filters. |
| Item | Meaning | Notes |
|---|---|---|
| Training samples | Number of local correction samples stored in this browser. | Limited locally; export or reset from Advanced corrections. |
| Suspicious range | Classifier score range for suspicious posts. | Current display: 0.45-0.69. |
| Privacy | Reminder that detection and feedback stay in chrome.storage.local. |
No server upload is used. |
| Friend/name alerts | Reserved Facebook-only note for future opt-in local history features. | Disabled by default. |
Facebook panels include feed filters, page cleanup, extras, and navigation cleanup.
| Filter | Targets |
|---|---|
| Suggested posts | Facebook feed items labeled or structured as suggestions or recommendations. |
| Reels | Short-video or Reel posts and modules in the feed. |
| Stories | Story modules or story-style feed placements. |
| People You May Know | People recommendation modules. |
| Pages: Follow suggestions | Page recommendation posts and modules asking you to follow a page. |
| Groups: Join suggestions | Group recommendation posts and modules asking you to join a group. |
| Marketplace posts | Marketplace sale, listing, and marketplace-style feed placements. |
| Games and apps | Game and app recommendation posts. |
| Events and birthdays | Event reminders, birthday modules, and event-style feed placements. |
| Memories | Facebook memories posts and reminders. |
| Friend activity | Posts surfaced primarily because a friend liked, followed, joined, or interacted. |
| All photo posts | Broad filter for photo posts. Use carefully because it can hide ordinary posts. |
| Videos and live | Video posts, live posts, and watch/video-style feed placements. |
| External links | Posts with outbound links away from Facebook. |
| Public posts | Posts detected as public. Use carefully if you follow many public pages. |
| Cleanup option | Targets |
|---|---|
| Right rail modules | General right-side modules outside the main feed. |
| Left nav clutter | Selected low-priority left navigation items. |
| Marketplace links | Marketplace entries in navigation areas. |
| Watch/video links | Watch, video, and similar navigation entries. |
| Gaming links | Gaming navigation entries and modules. |
| Events/memories links | Event and memory navigation entries. |
| Your shortcuts | The shortcuts section when detected. |
| Create room | Create Room modules and prompts. |
| Disable feed autoplay | Attempts to pause and disable autoplay on feed videos when possible. |
| Extra | Targets |
|---|---|
| Auto tag suggestions | Automatic tagging suggestions shown around posts or comments. |
| Suggested comments | Facebook suggested comment chips and prompts. |
| Typing comment notices | Notices that someone is typing a comment. |
| Highlight public posts | Visually marks posts detected as public instead of hiding them. |
| Home opens Most Recent | Attempts to route Home navigation toward a more recent feed view. |
| Navigation option | Targets |
|---|---|
| AI links | AI-related navigation links. |
| Friends links | Friends navigation entries. |
| Saved links | Saved navigation entries. |
| Memories links | Memory navigation entries. |
| Dashboard links | Dashboard navigation entries. |
| Groups links | Groups navigation entries. |
| Top Marketplace | Marketplace in the top navigation bar. |
| Top Watch/video | Watch or video in the top navigation bar. |
| Top Groups | Groups in the top navigation bar. |
| Top Gaming | Gaming in the top navigation bar. |
When Force missed post type is open on Facebook, the picker can force these categories:
Sponsored/ad post Page: Follow suggestion Group: Join suggestion Suggested/recommended post People You May Know Reel / short video Story module/post Marketplace post Game/app post Event/birthday post Memory post Friend activity post Photo post Video/live post External link post Public post
Reddit uses Promoted terminology and has Reddit-specific content filters.
| Filter | Targets |
|---|---|
| NSFW posts | Posts marked NSFW by Reddit signals. |
| Spoiler posts | Posts marked as spoilers. |
| Brand Affiliate posts | Posts with Reddit Brand Affiliate labeling. |
| Recommended posts | Posts inserted as recommendations or suggested communities/content. |
| Video posts | Posts containing Reddit video players or video-style post structures. |
| External link posts | Posts linking away from Reddit. |
When Force missed post type is open on Reddit, the picker can force these categories:
Promoted post NSFW post Spoiler post Brand Affiliate post Recommended post Video post External link post
LinkedIn filtering is conservative by default. Promoted posts are enabled; broader cleanup is opt-in.
| Filter | Targets |
|---|---|
| Suggested posts | LinkedIn recommendation modules, including "Recommended for you" profile modules and "Jobs recommended for you" job carousels when detected as feed modules. |
| Follow suggestions | Posts or modules encouraging you to follow a person, page, or profile. |
| Network activity posts | Feed posts surfaced because someone interacted with them, including headers such as "reposted this", "loves this", "celebrates this", "supports this", "commented on this", "reacted to this", "liked this", or "finds this insightful". |
| Promoted jobs | LinkedIn job promotion modules and promoted job cards. |
| Newsletter/event promos | Newsletter subscription promos, event promos, and similar LinkedIn promotional modules. |
| Video posts | Native LinkedIn videos, Video.js players, video cover images, video player labels, and late-mounted video shells. |
| External link posts | Posts with outbound links outside LinkedIn. |
When Force missed post type is open on LinkedIn, the picker can force these categories:
Promoted post Promoted job Suggested post Follow suggestion Network activity post Newsletter/event promo Video post External link post
Instagram support is paused in the current public build, but these option names can appear in stored settings or development builds.
| Filter | Intended target |
|---|---|
| Sponsored posts | Sponsored Instagram posts or Reels. |
| Product/promotional posts | Shopping, product, or promotional posts. |
| Suggested posts | Suggested Instagram feed posts. |
| Reels | Instagram Reel posts. |
| Video posts | Instagram video posts. |
| External link posts | Posts linking away from Instagram. |
The active-site detector currently treats Instagram as unsupported. The paused controls are documented for transparency, not as active public support.
Placeholders are the safest way to test filters because they let you recover hidden content.
Temporarily shows the hidden post with a frame so you can inspect why it was hidden.
Restores the hidden post without necessarily training the local model.
Restores the post and saves local feedback that it should not be treated as an ad.
Most issues are caused by a tab that was open before install/update, an inactive filter, or a page structure change.
1.1.4.85 or later.The extension is designed to work without server-side feed analysis.