Neat URL version history - 25 versions
Neat URL by Geoffrey De Belie
Be careful with old versions! These versions are displayed for testing and reference purposes.You should always use the latest version of an add-on.
Latest version
Version 2026.10.24.2
Released Oct 24, 2026 - 167.09 KBWorks with firefox 140.0 and later, android 140.0 and later- Added more default tracking parameters for Firefox, YouTube, Instagram, Google Ads, Amazon, and other websites.
- Fixed URL cleaning on Mozilla Add-ons and Support pages in Firefox.
- Chrome: reduced the number of declarativeNetRequest rules by about two-thirds.
- Added options to disable default blocked parameters, sync preferences across devices, and remove text fragments from URLs.
- Added website inclusion and exclusion lists.
- Added a browser theme icon option.
- Stopped removing PayPal's
campaign_idparameter, which is required for donation pages.
Source code released under GNU General Public License v2.0 only
Older versions
Version 2026.10.24.1
Released Oct 24, 2026 - 137.49 KBWorks with firefox 140.0 and later, android 140.0 and laterFirefox for Android: Neat URL can be installed there. Before, it would not have cleaned any URL, because Firefox for Android has no menus for the toolbar button and that stopped the background script. There is no menu to disable Neat URL on Android; the Log is on the options page.Source code released under GNU General Public License v2.0 only
Version 2026.10.24
Released Oct 24, 2026 - 137.37 KBWorks with firefox 140.0 and later- The version is now the date of the release. This is the successor of 5.0.0.
- Requirements: Firefox 140 or newer, or Chrome 121 or newer. Older browsers don't get this update.
- 6.0.0 was never officially released, so this contains all its changes (see below)
- Chrome: Neat URL replaces Linkumori, the temporary replacement in the Chrome Web Store. Its own parameters and whitelisted domains are added to Blocked parameters and Domain blacklist.
- Manifest V3 for Firefox and Chrome, fixes #291 (Chrome MV3) and #303 (Chromium)
- Firefox: URLs are still cleaned with a blocking webRequest listener
- Chrome: URLs are cleaned with declarativeNetRequest rules
- Supported features per browser: see docs/browser-support.md
- Firefox: you can turn off access to all websites in the add-on manager. Neat URL then can't clean any URL, and the options page shows a button to allow access again.
- New features
- Keep signed URLs (sig, hmac, ...signature), fixes #314 and #315. On by default.
- Clean URLs inside parameters, up to three levels deep (?url=https%3A%2F%2Fexample.com%2F%3Futm_source%3Dx). Off by default.
- Parameters with a value, for example ref=share@amazon.com, fixes #183
- Import and export of the preferences, fixes #175 and #301
- Groups in the parameter lists, with a header line ("Name:") or a label at the start of a line ("Tweakers: nb@tweakers.net, u@tweakers.net"), fixes #285. Before, such a label silently became a parameter named "Tweakers:nb".
- Wildcards in the domain blacklist (archive., .archive.*), fixes #286
- Change links in page: also cleans links that the page adds later, when they are used
- New options page in its own tab, with a dark theme
- Tabs Preferences, Appearance, Advanced and Log. The domain blacklist moved to Preferences.
- Test a URL: shows what Neat URL removes and which rules removed it, and suggests rules for the parameters that are left
- The default blocked parameters are a list per category: uncheck a parameter or category to keep it. This replaces "Override list for default blocked parameters".
- Log tab with the last 500 cleaned URLs and the rules that cleaned them, which can be saved for a bug report. Before saving, you see what goes into the file and can leave out the URLs and your own rules. The log is kept in memory only. This replaces the option "Enable logging".
- Unsaved changes are shown, with Undo changes and Ctrl+S
- The parameter lists warn about invalid rules, duplicates and parameters that are already a default
- A language picker, and better accessibility
- The cursor starts in Test a URL on Preferences, and in the filter on Log
- Toolbar button: a click opens Test a URL for the current tab. Enable/disable moved to the right-click menu.
- No more notifications, and no notifications permission: the options page shows "Preferences saved" itse
Source code released under GNU General Public License v2.0 only
Version 5.0.0
Released Apr 26, 2020 - 62.43 KBWorks with firefox 48.0 and later, android 48.0 to 68.** Fix #144 (XTOR): hash parameters work again
* Fix #161 (Ebay): add Ebay parameter hash@ebay.*
* Fix #167 (fbclid): add Facebook parameter fbclid
* Fix #176 (Google Analytics): add Google Analytics parameters gclid, gclsrc
* Fix #177 (merge commits) by updating this extension
* Fix #200 (double domains) by using publicsuffix-ccSLD
* Fix #204 (roadmap): consider this changelog to be the roadmap
* Fix #205 (block all placeholders using #*): add support for #* and #?*
* Fix #206 (Yandex parameters): added by default
* Fix #207 (hash): hash parameters work again
* Fix #216 (Matomo): add pk_*
* Fix #217 (outdated) by updating this extension
* Fix: mixing a root wild card domain with a suffix wildcard domain is now supported
* Adding default blocking parameters in new versions results in all users receiving the new parameters
* Existing default parameters included in the custom blocked parameters, will be deleted from the custom blocked parameters list
* Organised default blocking parameters into categories and into a JSON file
* This removes the need to have the default blocking list multiple times in the code base (options.js, background.js)
* Added Twitch.tv parameters tt_medium, tt_content
* Added MailChimp parameters mc_cid, mc_eid
* Added Google parameters gs_gbg@google.*, gs_mss@google.*, gs_rn@google.*, gs_lcp@google.*
* Added Google Analytics parameters gclid, gclsrc
* Added Amazon parameter pf@amazon.*
* Added AliExpress parameters algo_expid, algo_pvid, btsid, ws_ab_test
* Added Omniture tracking parameter s_cid
* Added Facebook parameters refsrc@facebook.com, hrc@facebook.com
* Added Yandex parameters lr@yandex.*, redircnt@yandex.*
* Added Ebay parameter hash@ebay.*
* Removed terminal_id, CNDID since the use is unknown
* Removed $/ref@amazon.* from the defaults due to suspected issues
* Options page: Add parameter rules URL
* Options page: Show default blocking parameters in a more organized way
* Options page: slightly adapt CSS styles
* README: update to the new default blocking parameters and use the new JSON format
* README: root wildcard domain and suffix wildcard domain can be combined; added an example
* README: organised "recommended parameters"
* README: added an explanation about addons.mozilla.org (related to #198)Source code released under GNU General Public License v2.0 only
Version 4.1.5
Released May 28, 2018 - 42.32 KBWorks with firefox 48.0 and later, android 48.0 to 68.** Use suffix lists to determine subdomains/top level domains, fixes #139Source code released under GNU General Public License v2.0 only
Version 4.1.4
Released May 25, 2018 - 42.06 KBWorks with firefox 48.0 and later, android 48.0 to 68.** Port to Chrome
* Extract CSS into separate filesSource code released under GNU General Public License v2.0 only
Version 4.1.3
Released May 8, 2018 - 40.62 KBWorks with firefox 48.0 and later, android 48.0 to 68.*Add _hsmiSource code released under GNU General Public License v2.0 only
Version 4.1.2
Released Apr 21, 2018 - 40.62 KBWorks with firefox 48.0 and later, android 48.0 to 68.*Remove ref, fixes #130 (caused by #118)Source code released under GNU General Public License v2.0 only
Version 4.1.1
Released Apr 17, 2018 - 40.59 KBWorks with firefox 48.0 and later, android 48.0 to 68.** Add spm@*.aliexpress.com, scm@*.aliexpress.com, aff_platform, aff_trace_key and terminal_id, fixes #103Source code released under GNU General Public License v2.0 only
Version 4.1.0
Released Apr 17, 2018 - 40.51 KBWorks with firefox 48.0 and later, android 48.0 to 68.** Add source@sourceforge.net, position@sourceforge.net, callback@bilibili.com, fixes #116
* Fix #97 revert counter color to default color
* Add eloqua tracking parameters #105
* Exception support #111
* Fix Neat URL breaks Google Product Forums #122
* Add ref, tag@amazon.*, ref_@amazon.* and pf_rd_*@amazon.* by default (fixes #118 #120 #125)
* Drop pd_rd_r@amazon.*, pd_rd_w@amazon.*, pd_rd_wg@amazon.* in favor of pd_rd_*@amazon.* (including automatic upgrade path)Source code released under GNU General Public License v2.0 only
Version 4.0.1
Released Dec 14, 2017 - 39.1 KBWorks with firefox 48.0 and later, android 48.0 to 68.** Fix ending parameters not detected when there are no query or hash parameters
* Fix regression: Amazon product pages are not cleaned when not all parameters are included
* Remove unused method parameters passed to removeEndings functionSource code released under GNU General Public License v2.0 only
Version 4.0.0
Released Dec 5, 2017 - 39.07 KBWorks with firefox 48.0 and later, android 48.0 to 68.** Performance improvements
* Several encoding bugs fixed #73 #75 #93
* Re-initialise listener, hopefully fixes #92
* Fix "Show counter" setting (introduced in 3.2.0) doesn't do anything #91
* Workaround for gws_rd@google.* on google.com #76
* Implement hash parameters using #? #83
* Cleanups
* Fix translation string mapped to wrong i18n id
* Move most functions related to the toolbar button to a separate file
* Automatically remove newlines from the Blocked parameters textarea when savingSource code released under GNU General Public License v2.0 only
Version 3.2.0
Released Oct 18, 2017 - 38.3 KBWorks with firefox 48.0 and later, android 48.0 to 68.** Add counter which shows the number of rewritten URLs #60
* Add option to show/hide counter
* Add option to set the counter background color
* Fix addons.mozilla.org logic and change applyAfter to 1000ms #42
* Drop tracking feature introduced in 3.1.0 #58
* Add blacklist feature to skip certain URLs
* Skip rewriting urls which contain ?? #66
* Empty list of request types now means no request types are filtered at allSource code released under GNU General Public License v2.0 only
Version 3.1.1
Released Oct 10, 2017 - 32.81 KBWorks with firefox 48.0 and later, android 48.0 to 68.** Fix handling of addons.mozilla.org again, browser.tabs.update triggers a new request, catch that
* Change applyAfter from 400ms to 300ms on addons.mozilla.orgSource code released under GNU General Public License v2.0 only
Version 3.1.0
Released Oct 10, 2017 - 32.8 KBWorks with firefox 48.0 and later, android 48.0 to 68.** Fix some websites breaking / problems caused by the use of URL() constructor #52
* Default request filter will now only filter "main_frame" requests - see the advanced section of the options to change that (tip: if you want all requests to be filtered, you can use an empty value - it might break some sites, so make sure you report all URLs which do not work in this mode). #48 #52 livejournal.com
* Safer handling of addons.mozilla.org - only main_frame requests will be changed to prevent issues. #48
* Added tracking protection - it will cancel requests to listed domains
* Expanded existing localisations
* Explicit support for stripping of # parameters
* Fix double dollar supportSource code released under GNU General Public License v2.0 only
Version 2.1.2
Released Oct 1, 2017 - 28.63 KBWorks with firefox 48.0 and later, android 48.0 to 68.** Fix problem with URL decoding
* Keys are now case sensitiveSource code released under GNU General Public License v2.0 only
Version 2.1.1
Released Sep 30, 2017 - 28.61 KBWorks with firefox 48.0 and later, android 48.0 to 68.** Do not update a tab to an empty URLSource code released under GNU General Public License v2.0 only
Version 2.1.0
Released Sep 30, 2017 - 28.79 KBWorks with firefox 48.0 and later* Fix handling of addons.mozilla.org and mozilla.org again
* On Amazon product pages, all parameters are removed
* Add light icons for dark themes, can be set in the optionsSource code released under GNU General Public License v2.0 only
Version 2.0.5
Released Sep 24, 2017 - 20.25 KBWorks with firefox 48.0 and later, android 48.0 to 68.** Fix handling of mozilla.orgSource code released under GNU General Public License v2.0 only
Version 2.0.4
Released Sep 20, 2017 - 20.18 KBWorks with firefox 48.0 and later* Fix problem related to Google Docs - see https://addons.mozilla.org/nl/firefox/addon/neat-url/reviews/918997/
* Add _hsenc and mkt_tok to Neat URL defaultsSource code released under GNU General Public License v2.0 only
Version 2.0.3
Released Sep 5, 2017 - 20.11 KBWorks with firefox 48.0 and later, android 48.0 to 68.*Important bugfix preventing some users from getting upgraded parametersSource code released under GNU General Public License v2.0 only
Version 2.0.2
Released Sep 4, 2017 - 19.91 KBWorks with firefox 48.0 and later, android 48.0 to 68.*Add utm_cid for mashable.comSource code released under GNU General Public License v2.0 only
Version 2.0.1
Released Aug 31, 2017 - 19.91 KBWorks with firefox 48.0 and later, android 48.0 to 68.** Introduce $$ to force remove everything after a certain string
* Change $ behaviour to remove everything after a certain string only if there are no query parameters after reducing the query parameters (no longer breaks Amazon links)
* Drop utils/compareVersions.js (no longer needed)Source code released under GNU General Public License v2.0 only
Version 2.0.0
Released Aug 30, 2017 - 20.94 KBWorks with firefox 48.0 and later, android 48.0 to 68.** Added domain wildcards
* Added support for anchor tags
* Made upgrading of parameters between versions more robust
* Fixed context menu listeners staying attached after removing them
* Add gs_l parameter retroactively
* Add new default parameters: pd_rd_r@amazon.*, pd_rd_w@amazon.*, pd_rd_wg@amazon.*, _encoding@amazon.*, psc@amazon.*, ved@google.*, ei@google.*, sei@google.*, gws_rd@google.*, cvid@bing.com, form@bing.com, sk@bing.com,
sp@bing.com, sc@bing.com, qs@bing.com, pq@bing.com, feature@youtube.com, gclid@youtube.com, kw@youtube.com, $/ref@amazon.*
* Expanded READMESource code released under GNU General Public License v2.0 only
Version 1.2.0
Released Aug 20, 2017 - 19.58 KBWorks with firefox 48.0 and later, android 48.0 to 68.*- Fix options.js resizing of textarea width under certain conditions
- Add parameter gs_l and provide an automatic upgrade path for users using earlier versionsSource code released under GNU General Public License v2.0 only