MozillaZine

Chrome URLs

From MozillaZine Knowledge Base

To overlay an existing XUL element, you first need the URL of its chrome.

Contents

Finding Chrome URLs not listed below

If you can open the desired chrome element in its own window or popup, make sure you have the DOM Inspector extension installed (it comes bundled with some applications, not with others), then:

  • Open your chrome element's window
  • Start the DOM Inspector via the appropriate submenu or sub-submenu of the Tools menu (its exact location varies between applications, and with the presence or absence of some other extensions), or by hitting Ctrl+Shift+I
  • In the DOM Inspector window, use the "File => Inspect Chrome Document" menuitem to select your chrome element's window
  • The desired chrome URL should appear in the DOM Inspector's URL bar.

Search for chrome content

You can also use a Mozilla code search tool such as MXR to find the source files for chrome content by searching for text in the content. Note that toolkit code assembles much of the text you see from smaller bits of text to ease localization. For example, if you see "Welcome to SeaMonkey Help", the chrome content is actually "Welcome to &brandShortName; Help". So if you don't get a search result try searching for something smaller.

Chrome URLs map to file locations

However, note that toolkit code maps chrome URLs to locale-specific directories, for example SeaMonkey's chrome://locale/communicator/help/welcome_help.xhtml maps to the file /chrome/en-US/locale/en-US/help/firefox_welcome.xhtml (for someone with the U.S. English build of SeaMonkey).

Look in omni.ja

In 2011 and later versions of Firefox and SeaMonkey, most built-in chrome content is packaged inside the single large file omni.ja. This is a JAR file which uses the ZIP file compression format. So you can explore this with the "unzip" tool of your choice to look at its contents.

jar: to look at ZIP content in the browser

Firefox and SeaMonkey support the "jar:" URL protocol to access content in ZIP files. If you load a chrome URL, then view its URL or choose Page Info, you may see the URL transform to something like

jar:file:///path/to/seamonkey program/omni.ja!/chrome/en-US/locale/en-US/help/firefox_welcome.xhtml

An expert user can edit these URLs to investigate the contents of omni.ja (or in fact any locale zip file), although the user interface is quirky and error handling non-existent.

All Toolkit applications

Firefox, Thunderbird, Sunbird, SeaMonkey (2.0a1pre and later), ...
 

 
 This section is incomplete. If you know what's missing, please fill it in.
 

 

Function URL
Add-ons chrome://mozapps/content/extensions/extensions.xul
DOM Inspector chrome://inspector/content/inspector.xul

Firefox

Function URL
Main Window chrome://browser/content/browser.xul
Options chrome://browser/content/preferences/preferences.xul
Firefox 1.5: chrome://browser/content/pref/pref.xul
Library chrome://browser/content/places/places.xul
Firefox 1.5: chrome://browser/content/bookmarks/bookmarksManager.xul
Bookmark Panel chrome://browser/content/bookmarks/bookmarksPanel.xul
History Panel chrome://browser/content/history/history-panel.xul
Downloads chrome://mozapps/content/downloads/downloads.xul
Clear Private Data chrome://browser/content/sanitize.xul
Saved Passwords chrome://passwordmgr/content/passwordManager.xul
Error Console chrome://global/content/console.xul
Manage Cookies chrome://browser/content/preferences/cookies.xul


Firefox Help Links

Function URL
Mozilla Firefox Help chrome://help/locale/firefox_welcome.xhtml
Using the Help Window chrome://help/locale/welcome.xhtml
Using Mozilla Firefox chrome://help/locale/using_firebird.xhtml
Using the Download Manager chrome://help/locale/download_manager.xhtml
Customization chrome://help/locale/customization.xhtml
Options (Preferences) chrome://help/locale/prefs.xhtml
Controlling Popups chrome://help/locale/popup.xhtml
Managing Cookies chrome://help/locale/cookies.xhtml
Tabbed Browsing chrome://help/locale/tabbed_browsing.xhtml
Keyboard Shortcuts chrome://help/locale/shortcuts.xhtml
Mouse Shortcuts chrome://help/locale/mouse_shortcuts.xhtml
Menu Reference chrome://help/locale/menu_reference.xhtml
Help for Internet Explorer Users chrome://help/locale/forieusers.xhtml
Glossary chrome://help/locale/glossary.xhtml

Thunderbird

 

 
 Please fill in.
 

SeaMonkey 2.0 and later

 

 
 Please complete.
 
Function URL
Main help chrome://locale/communicator/help/welcome_help.xhtml

early Mozilla Suite and SeaMonkey 1.0/1.1

Function URL
Main Window chrome://navigator/content/navigator.xul
Search Panel chrome://communicator/content/search/search-panel.xul
Bookmark Panel chrome://communicator/content/bookmarks/bm-panel.xul
History Panel chrome://communicator/content/history/history-panel.xul
Addressbook Panel chrome://messenger/content/addressbook/addressbook-panel.xul
Bookmark Manager chrome://communicator/content/bookmarks/bookmarksManager.xul
History Window chrome://communicator/content/history/history.xul
Manage Cookies chrome://communicator/content/permissions/cookieViewer.xul
Image Permissions chrome://communicator/content/permissions/permissionsManager.xul
Manage Popups chrome://communicator/content/permissions/permissionsManager.xul
Preferences chrome://communicator/content/pref/pref.xul
Saved Passwords chrome://communicator/content/wallet/SignonViewer.xul
Error Console chrome://global/content/console.xul
DOM Inspector chrome://inspector/content/inspector.xul
Mail & News chrome://messenger/content/messenger.xul
Address Book chrome://messenger/content/addressbook/addressbook.xul
Composer chrome://editor/content/editor.xul
Chatzilla chrome://chatzilla/content/chatzilla.xul
Calendar chrome://calendar/content/calendar.xul

Sunbird

 

 
 Please fill in.
 

Camino

 

 
 Please fill in.
 

Using the chrome URL

Once you've got your chrome URL you can load it (by typing it in the location bar), and use the DOM inspector's click-to-select tool to locate the element and get its ID.

See Also

External Links