About:config: Difference between revisions

From MozillaZine Knowledge Base
Jump to navigationJump to search
(→‎Adding modifying and resetting preferences: added '''Toggle''' selection)
No edit summary
Line 1: Line 1:
{{wrongtitle|title=about:config}}
{{wrongtitle|title=about:config}}
'''about:config''' (one of the special [[About_protocol_links]]) lists  application preferences read from "prefs.js", "[[user.js]]" and from program defaults, many of which are not present in the  Options and Preferences dialog. You can use about:config to  modify these preferences and to add other "hidden" preferences. '''Warning''': Changing these values can, in rare circumstances, break Mozilla Suite, Firefox, or Thunderbird or cause strange behavior. Only modify these preferences if you know what you are doing.  
<tt>about:config</tt> (one of the special [[About_protocol_links|about: links]]) lists  application preferences read from "prefs.js", "[[user.js]]" and from program defaults, many of which are not present in the  Options and Preferences dialog. You can use about:config to  modify these preferences and to add other "hidden" preferences.
 
'''Warning''': Changing these values can, in rare circumstances, break Mozilla Suite, Firefox, or Thunderbird or cause strange behavior. Only modify these preferences if you know what you are doing.  


==Opening about:config==
==Opening about:config==
Line 8: Line 10:
   
   
==Adding modifying and resetting preferences==
==Adding modifying and resetting preferences==
To add a new preference, context-click (right-click) anywhere in the list of preferences, select '''New''' then select the type of preference.  ''String'' is textual, ''Boolean'' is true-false and ''Integer'' is numerical.
To add a new preference, context-click (right-click) anywhere in the list of preferences, select ''New'' then select the type of preference.  ''String'' is textual, ''Boolean'' is true-false and ''Integer'' is numerical.
    
    
To modify an existing preference, context-click (right-click) on the  preference,  select '''Modify''' and type in  the new value.  In some cases, '''Toggle''' will be the selection offered for boolean (true-false) preferences.
To modify an existing preference, context-click (right-click) on the  preference,  select ''Modify'' and type in  the new value.  In some cases, ''Toggle'' will be the selection offered for boolean (true-false) preferences.


To reset a preference to its default value or to remove an added preference,  context-click (right-click) on the preference and select '''Reset'''.
To reset a preference to its default value or to remove an added preference,  context-click (right-click) on the preference and select ''Reset''.


==about:config entries==
==about:config entries==
Line 24: Line 26:
* [http://preferential.mozdev.org/ Preferential extension] &mdash; An extension similar to about:config with extra features, such as documentation for some preferences.
* [http://preferential.mozdev.org/ Preferential extension] &mdash; An extension similar to about:config with extra features, such as documentation for some preferences.
* [[About protocol links]] &mdash; other about: pages.
* [[About protocol links]] &mdash; other about: pages.
[[Category:Configuration]]

Revision as of 12:04, 19 September 2005

about:config (one of the special about: links) lists application preferences read from "prefs.js", "user.js" and from program defaults, many of which are not present in the Options and Preferences dialog. You can use about:config to modify these preferences and to add other "hidden" preferences.

Warning: Changing these values can, in rare circumstances, break Mozilla Suite, Firefox, or Thunderbird or cause strange behavior. Only modify these preferences if you know what you are doing.

Opening about:config

  • In Firefox and Mozilla Suite, type "about:config" (without quotes) in the Location Bar and press Enter.
  • In Thunderbird, use the AboutConfig extension. Starting with Thunderbird 1.5, about:config is accessible from the "Tools" menu (Options > Advanced > Config Editor button).
  • There's a version of AboutConfig extension compatible with Nvu here.

Adding modifying and resetting preferences

To add a new preference, context-click (right-click) anywhere in the list of preferences, select New then select the type of preference. String is textual, Boolean is true-false and Integer is numerical.

To modify an existing preference, context-click (right-click) on the preference, select Modify and type in the new value. In some cases, Toggle will be the selection offered for boolean (true-false) preferences.

To reset a preference to its default value or to remove an added preference, context-click (right-click) on the preference and select Reset.

about:config entries

This article contains a list of valid about:config entries and their possible values. (That article is a reference for what each preference does, it is not the place to edit your preferences.)

References