MozillaZine

About:config

From MozillaZine Knowledge Base

(Difference between revisions)
Revision as of 12:34, 10 September 2005
Alice (Talk | contribs)
(Adding modifying and resetting preferences - added '''Toggle''' selection)
<-- Previous diff
Revision as of 12:04, 19 September 2005
Asqueella (Talk | contribs)

Next diff -->
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.

Contents

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