Interface
💡 Tooltips show useful help in all the interfaces. Display them by hovering the mouse on question marks 
The popup is opened by clicking the toolbar icon and looks like this:
The toolbar icon, popup title (1), and CleanLinks logo in the top left corner of the popup (2) indicate whether the add-on is
active 
The popup’s center show the history of cleaned links (3) with original links, followed by cleaned links. These are prefixed with ► when redirected end ❌ when cancelled.
Filters (4) (5) are shown as boxes in the top part of the popup, allow to filter the history of cleaned links that is displayed below (3). There are 2 types of filters
-
Link type ((4), see Request types). When enabled, show in the history requests that are respectively:
-
pages opened in the top-level frame − most likely clicked from within or outside of the browser ;
-
document-initiated requests − typically resources such as scripts and images ;
-
header redirects.
-
-
Action type (see embedded URLs and parameter removal). When enabled, show in the history requests that have been cleaned respectively:
-
by skipping intermediate pages straight to the embedded URL ;
-
by removing parameters ;
-
by rewriting (search + replace) the URL path ;
-
by removing a javascript function.
-
pages opened in the top-level frame − most likely clicked from within or outside of the browser ;
document-initiated requests − typically resources such as scripts and images ;
header redirects.
by skipping intermediate pages straight to the embedded URL ;
by removing parameters ;
by rewriting (search + replace) the URL path ;
by removing a javascript function.Clicking a cleaned link in the history selects it (6). This is marked by a blue border on the left, and the link text is wrapped to be displayed in full. On each link, the cleaning actions are displayed as follows:
- Parameters or parts of the path removed of the URL
- Parts of the path inserted into the URL
- Whitelisted parts of the URL, left untouched
- Location of the detected embedded URL
💡 You can copy selected a dirty/clean link pair by using Ctrl + C (resp. Cmd + C on macOS).
Buttons on the bottom (7) perform various actions:
-
Non-link related actions:
-
Toggle (enable/disable) the add-on for this tab.
-
Empty the displayed history of cleaned links (6)
-
Refresh the page
-
-
Actions based on the selected link:
-
Whitelist once: loads the URL without cleaning it at all.
-
Add to whitelist: adds the parameter (or path) with the embedded URL to the whitelist to allow it.
-
Remove parameter: adds the parameter (or path) with the embedded URL to the rules to remove it.
-
Edit rules: open the settings page with the selected link pre-populated for modification.
-
Toggle (enable/disable) the add-on for this tab.
Empty the displayed history of cleaned links (6)
Refresh the page
Whitelist once: loads the URL without cleaning it at all.
Add to whitelist: adds the parameter (or path) with the embedded URL to the whitelist to allow it.
Remove parameter: adds the parameter (or path) with the embedded URL to the rules to remove it.
Edit rules: open the settings page with the selected link pre-populated for modification.🚧 This section is still being written. Please refer to the help tooltips that appear when hovering question marks
⚠️ Rules need to be saved after being modified
- Greyed items are inherited from parent rules.
- To counter-act a greyed out item, either:
- add the same item to the whitelist of the rule you’re editing − this overrules the removals, or
- go to the parent rule (listed above the rules editing and above the add/save/erase buttons − in general the global rule
*.*).