Adblock Plus preferences
The following table lists and explains all preferences that are used by Adblock Plus. These preferences can be viewed and changed via about:config.
| Preference | Default value | Comments |
|---|---|---|
| Visible options | ||
| extensions.adblockplus.correctTypos | false | Value of the "Correct mistyped internet addresses" options |
| extensions.adblockplus.enabled | true | Value of the "Enable Adblock Plus" option |
| extensions.adblockplus.fastcollapse | false | Reverse of the "Hide placeholders of blocked elements" option |
| extensions.adblockplus.frameobjects | true | Value of the "Show tabs on Flash and Java" option |
| extensions.adblockplus.savestats | true | Value of the "Count filter hits" option |
| extensions.adblockplus.showinstatusbar | false | Value of the "Show in status bar" option |
| extensions.adblockplus.whitelist | {} | Domains names that have been added to the typo correction whitelist |
| extensions.adblockplus.clearStatsOnHistoryPurge | true | If true, clearing browsing history will also clear hit statistics for Adblock Plus filters. Note that the hit statistics often allow deducing which sites the user visited, when and how often. |
| extensions.adblockplus.composer_default | 2 | Determines which suggestion should be selected in the filter composer by default: 0 — custom pattern 1 — exact address only 2 — entire directory 3 — entire site |
| extensions.adblockplus.data_directory | adblockplus | The directory where Adblock Plus should store its data. This can be either an absolute path, or it can a directory location relative to the user's profile. If patternsfile preference is set it will override the location for patterns.ini file while other files stay in this directory. |
| extensions.adblockplus.defaultstatusbaraction | 0 | Defines the action that should be executed when the status bar icon is clicked. For list of possible values see defaulttoolbaraction. |
| extensions.adblockplus.defaulttoolbaraction | 0 | Defines the action that should be executed when the toolbar icon is clicked. Possible values are: 0 — show menu 1 — open/close blockable items 2 — show Preferences dialog 3 — enable/disable Adblock Plus anything else — do nothing |
| extensions.adblockplus.enable_key | empty | Defines the keyboard shortcut to be used to enable/disable Adblock Plus. For description of possible values see sidebar_key. Note: This setting will only apply after the browser is restarted. |
| extensions.adblockplus.filters_key | Accel Shift E, Accel Shift F, Accel Shift O | Defines the keyboard shortcut to be used to open Filter Preferences dialog. For description of possible values see sidebar_key. Note: This setting will only apply after the browser is restarted. |
| extensions.adblockplus.flash_scrolltoitem | true | Defines whether "Flash item's borders" in the list of blockable items should try to scroll the item into view. |
| extensions.adblockplus.patternsbackupinterval | 24 | Minimal interval between two backups of patterns.ini (in hours) |
| extensions.adblockplus.patternsbackups | 5 | Number of backups for patterns.ini that should be kept. If this is 0, backups will be disabled. |
| extensions.adblockplus.patternsfile | empty | Name of the file that should be used to store the list of filters. This can be either an absolute path, or it can be file's location relative to the user's profile. |
| extensions.adblockplus.previewimages | true | Defines whether the tooltip in the list of blockable items should show the image that the item represents. |
| extensions.adblockplus.sendReport_key | empty | Defines the keyboard shortcut to be used to send issue reports. For
description of possible values see sidebar_key.
Note: This setting will only apply after the browser is restarted. |
| extensions.adblockplus.sidebar_key | Accel Shift V, Accel Shift U | Defines the keyboard shortcut to be used to open blockable items. This preference can be empty or it can be of the form modifier1 modifier2 key. Recognized modifiers are: Shift, Accel (default accelerator key, e.g. Ctrl on Windows, Command on Mac OS X), Ctrl/Control, Alt, Meta. Key can be either a letter or a special key like F7 or RIGHT (see nsIDOMKeyEvent interface for a list of special keys). Starting with Adblock Plus 1.3.5 multiple comma-separated shortcuts can be specified, the first available keyboard shortcut from the list will be used. Note: This setting will only apply after the browser is restarted. |
| extensions.adblockplus.subscriptions_autoupdate | true | Defines whether filters in filter subscriptions will be updated
automatically. Note: Disabling updates is not recommended. |
| extensions.adblockplus.subscriptions_exceptionscheckbox | true | If true, the filter list for non-intrusive ads
will get special treatment and will be displayed as a checkbox in the user
interface. |
| extensions.adblockplus.synchronizationinterval | 24 | Minimal interval between two subsequent downloads of a subscription (in hours) |
| Remembered actions | ||
| extensions.adblockplus.blockableItemsSize | {width: 200, height: 200} | Remembered size of the Blockable Items list (width setting is only relevant when displayed as a sidebar). |
| extensions.adblockplus.correctTyposAsked | false | This is set to true after the user made a decision on the typo
correction opt-in prompt. |
| extensions.adblockplus.currentVersion | 0.0 | Stores the last used Adblock Plus version, this will trigger actions that need to be done on upgrade or first install |
| extensions.adblockplus.detachsidebar | false | Stores state of the list of blockable items — true means detached |
| extensions.adblockplus.hideContributeButton | false | This is set to true if the user chose to hide the
Contribute button. |
| extensions.adblockplus.recentReports | [] | JSON-encoded data on recently submitted issue reports (address of the report, website reported and time of submission) |
| Internal preferences (don't change unless you really know what you are doing) | ||
| extensions.adblockplus.documentation_link | Address on adblockplus.org to be opened for documentation links. It will redirect to the actual documentation location depending on the language used. | |
| extensions.adblockplus.lastRuleUpdate | 0 | Timestamp of the last attempt to update typo correction rules |
| extensions.adblockplus.report_submiturl | Address on adblockplus.org to submit issue reports to. | |
| extensions.adblockplus.subscriptions_exceptionsurl | Location of the filter list used to allow non-intrusive ads. | |
| extensions.adblockplus.subscriptions_fallbackerrors | 5 | Sets the required number of failed subscription download attempts before the fallback script (see subscriptions_fallbackurl) will be consulted for the new address of the subscription. Note that Adblock Plus will always retry a download one day after a failed download attempt. |
| extensions.adblockplus.subscriptions_fallbackurl | Address of the script that should be consulted if a subscription fails to download a certain number of times (see subscriptions_fallbackerrors). %s is replaced by the address of the subscription in question. The script should print something like "301 http://example.com/new_list.txt" if the new location of the subscription is known. | |
| extensions.adblockplus.subscriptions_listurl | Address to download the complete list of filter subscriptions from. | |
| extensions.adblockplus.whitelistschemes | about chrome file irc keyword moz-safe-about news resource snews x-jsd addbook cid imap mailbox nntp pop data javascript | List of URL schemes that shouldn't be blocked (applied to both whole documents and to item locations) |
| Removed preferences | ||
| extensions.adblockplus.blocklocalpages | Unused in Adblock Plus 0.7.5 and higher | |
| extensions.adblockplus.blocktypes | Unused in Adblock Plus 0.7.5 and higher | |
| extensions.adblockplus.checkedadblockinstalled | Unused in Adblock Plus 1.0 and higher | |
| extensions.adblockplus.checkedadblockprefs | Unused in Adblock Plus 0.7.5 and higher | |
| extensions.adblockplus.checkedadblocksync | Unused in Adblock Plus 0.7.5 and higher | |
| extensions.adblockplus.checktoolbar | Unused in Adblock Plus 1.0 and higher | |
| extensions.adblockplus.grouporder | Unused in Adblock Plus 0.7.5 and higher | |
| extensions.adblockplus.hideimagemanager | Unused in Adblock Plus 2.1 and higher | |
| extensions.adblockplus.linkcheck | Unused in Adblock Plus 0.7.5.4 and higher | |
| extensions.adblockplus.linktypes | Unused in Adblock Plus 0.7.5 and higher | |
| extensions.adblockplus.localschemes | Unused in Adblock Plus 0.7.5 and higher | |
| extensions.adblockplus.noncollapsabletypes | Unused in Adblock Plus 0.7.5 and higher | |
| extensions.adblockplus.patterns | Unused in Adblock Plus 0.7.5 and higher | |
| extensions.adblockplus.protectchrome.* | Unused in Adblock Plus 1.0 and higher | |
| extensions.adblockplus.settings_key | Unused in Adblock Plus 2.0 and higher | |
| extensions.adblockplus.showintoolbar | Unused in Adblock Plus 2.0 and higher | |
| extensions.adblockplus.showsubscriptions | Unused in Adblock Plus 1.0 and higher | |
| extensions.adblockplus.synchronizationinterval | Unused in Adblock Plus 2.0 and higher | |
| extensions.adblockplus.warnregexp | Unused in Adblock Plus 1.0 and higher | |