Wikipedia:User scripts

WP:US redirects here. This page replaces Wikipedia:WikiProject User scripts. For the United States project, see Wikipedia:WikiProject United States. For USA abbreviation guidance, see Wikipedia:Manual of Style#US.

User scripts
User scripts are powerful customizations, authored by the community, that allow registered Wikipedians to change Wikipedia's interface beyond the options available in preferences. This page provides a list of available scripts and instructions on installing them. User scripts are written in JavaScript. Click here to skip directly to the script list. Many of the most popular scripts become gadgets, and are subsequently removed from this page. You can enable them via Preferences - Gadgets. It is recommended that you check there first for any tool you might be looking for, since gadgets have been widely tested and proven useful and reliable. Most scripts are designed and tested primarily with the Vector skin, Wikipedia's current default.
How to install user scripts: (Simple method for scripts located on English Wikipedia) First, make sure you are registered and logged in. Only logged-in users can install scripts. Click here to edit your common.js file. Add the following line: {{subst:iusc|script_path}} -- replace "script_path" with the full name of the .js page that opens when a script's "(source)" link is clicked. For example, to install the Sharebox script, add the following line: {{subst:iusc|User:TheDJ/sharebox.js}} Save the page and bypass your cache to make sure the changes take effect.
Automatic installer: Script Installer makes script installations fully automatic. The installer itself must first be installed manually. Afterwards, scripts can be installed with a single click.

Site-wide appearance

For reading

Scripts that offer superficial site-wide changes to ease browsing.

• Sharebox (source) – Adds social networking share buttons.
• Hide Vector Sidebar (source) – Hides the left sidebar in Vector. Can access the sidebar anytime by alt-shift-a.
• SimpleLightbox (source) – A simple lightbox which enlarges images without leaving the page, faster and easier than Media Viewer.
• Picture Popups (source) – Enlarge images without leaving the page and without disabling the page content. Doesn't work with the Modern skin.
• Smaller Templates (source) – Makes maintenance templates appear smaller, both horizontally and vertically.
• Subject's Age From Year (source) – Roll over any year in an article about a dated subject and see the age of that subject that year.
• mathJax (source) – High-quality LaTeX font typesetting via MathJax.
• wiktLookup (source) – Double-click a word, and go to its definition on Wiktionary.
• goToTop (source) – (Handy for phones) Adds a small button to the left of the page which moves to the top of the page instead of having to scroll there. If you installed this before May 2013, you will need to reinstall it.
• Floater (source) – A thin floating toolbar that slides smoothly into view when you scroll down any page, providing constant access to commonly used tools that normally sit at the top of pages, including the search bar.
• FloatHead (source) – makes the Wikipedia head navigation floating.
• Wide Skin (source) – Hides the sidebar and transfers its links to menus and the footer. Tested with the Vector skin.

Search

Modify the site's search bar.

• SearchNamespace (source) – Adds a pulldown menu next to the quick search bar allowing selection of namespace to search in.
• Open search in new tab (source) – Use Ctrl-click (PC) or Command-click (Mac) to open search results list or suggestions in new tab.
• Open search in new tab automatically (source) – Open search results list or suggestions in new tab automatically.
• Google Title (source) – Adds a link next to an article's title to search Google for that title in a new tab.

For editing

Scripts that offer superficial site-wide changes aimed at those who edit actively or participate in discussions.

Inline

• Link Classifier (source) – Colors links on the page to indicate redirects, broken redirects, disambiguation pages, and XfDs by default.
• Duplinks (source) – Highlights links that occur more than once in an article (separate for lead and body).
• Copy section link (source) – Adds a linked pilcrow on section header mouseover for making section links faster/easier.
• Autolink (source) – Makes plaintext [[wikilinks]], {{transclusions}}, and URLs clickable where they normally aren't (i.e. in the History tab and on .js pages).
• intropreload (source) – shows links next to page title to the edit intro and preloaded content (if they exist)
• WikiTrust – Click on text in an article to get information about who added that text, and when. Uses data from the WikiTrust project. Appears broken. See here.
• ToggleEditNotices – Allows toggling of edit notices.

Discussion oriented

• Nominations Viewer (source) – Collapses the nominations on pages like WP:FAC and WP:PR into expandable headers with basic information on the nomination, significantly decluttering the pages.
• Admin Rights (source) – Highlights administrators in all listings and signatures.
• Mark Blocked (source) – Marks blocked users in all listings and signatures (faded and struck-out username).
• Vote Symbols (source) – Adds graphical icons to users' !votes in discussions.
• Comment Highlighter (source) – Highlights your discussion comments.
• Deletion Finder (source) – Adds links to the deletion log and any AfD discussions next to an article's title (only if there are any).
• Unclutter (source) – hides excessive warnings, makes some of the interface collapsible and minimises signatures.
• ClerkingTBLinks (source) – Makes it easy to post talkback messages to users who have open requests that need further information. Currently coded for WP:CHU/S, WP:CHU/U and WP:FFU.

Menus and tabs

• 6 Tabs Vector (source) – Shows edit and history tabs for both main and talk pages while viewing either one.
• No Edit Sandbox (source) – Changes the "My sandbox" link to a regular page link, instead of loading the sandbox's edit page by default.
• Family Tree Editor (source) – Creates Family Trees with Chart Template.
• Wiki Translation Tools (source) – Helps you find categories, automatically fills the {{Translated page}} template, etc., based on an article in another Wikipedia. You have to install it in the Wikipedia you are translating from.
• addptlinks (source) – Allows you to add custom links to your personal toolbar

Toolbox

Scripts that add links to the toolbar that display additional information or highlight things.

• dabfinder (source) – adds two links in the toolbox, one that highlights redirects and one that highlights disambiguation links.
• New Pages (source) – Adds a link "Patrol New Pages" link in the toolbox.
• Sidebar History Tools (source) – Brings the History page's Toolserver links (plus the Page logs link) to the sidebar, so you don't need to navigate to the History page first to see them.
• Prose Size (source) – Adds a link to the sidebar's toolbox to view various page size statistics. Although useful for DYK, see DYKcheck for a more durable build.

Editing

Scripts that add to or refine editors' toolsets.

• Heading editor (source) – allows for one-click editing of section headings while reading an article
• Sagittarius (source) – for editing redirects.
• Smart Linking (source) – Helps linking to the correct articles by letting you preview the linked articles while editing (see the screenshots).
• Simple Keyboard Layout Changer (source) – change just a few characters on your keyboard or set up complete keyboard layouts for typing in other languages (works in both the editing area and the search box).

Inline

• Advisor (source) – Flags possible issues with wikitext while editing a page.
• Autocomplete (source) – Offers a popup suggestions menu whenever you start typing a link or template in the main edit box.
• Template parameters wizard (source) – Helps fill parameters of templates.
• Bracket Match (source) – Check matching for template and variable brackets.

Previewing

• ajaxPreview (source) – Allows editing preview and changes without page reloading.
• Ajax Preview (source) – Adds a button to the edit form to preview the current section, with a references section included.
• Split Preview (source) – Shows editing previews beside the edit box instead of above or below.
• Preview: Template Last Modified (source) – When previewing changes, sorts list of called templates by date last modified and displays the latest edit summary for each; useful for debugging complex templates.
• UniversalTransclusionPreviews (source) – Preview transclusions from any namespace.

Extra functions

• Save&Edit (source) – adds a small button to save the actual content and goes directly to the edit page again.
• Split Edit Summary Box (source) – Creates a separate edit summary box for the name of the edited section, making the browser's autocomplete function more useful.
• Custom Summary Presets (source) – Adds a menu below the edit summary line where you can choose from your own preset edit summaries.
  • Revised version allowing theoretically infinite custom summaries using an array. Placed here due to User:Equazcion's suggestion.
• Math editor (source) – Adds math editor for enhanced editing toolbar, which provides online preview while typing equations.
• Table Editor (source) – add table editing helpers to the toolbar
• TemplateData Editor (source) – Adds a link in the toolbox for editing ‎<templatedata>...‎</templatedata> tags in templates.
• DisamAssist (source) – Assists in quickly fixing ambiguous links
• WhatLinksHere enhancement (source) – Adds tabs to WhatLinksHere pages which allow a user to filter the list of links. Designed years ago with disambiguation in mind, and duplicates many features since added to the standard WLH page. Quick way to get counts of links by type.

Cleanup

Scripts docked to the toolbox that, when executed, automatically clean up the page in some manner.

• AutoEd (source) – Cleanup various problems with markup, headlines, templates, and ISBNs.
• autoFormatter – A user script that semi-automatically fixes more than 200 common errors in wiki markup.
• dashes (source) – fixes hyphens, dashes, and minus signs per MOS:DASH.
• EngvarB (source) – British and Canadian spelling consistency per WP:ENGVAR.
• MOSNUM Dates (source) – Cleanup dates per WP:MOSNUM.
• Common Terms (source) – Delink common terms.
• formatgeneral (source) – Formatting fixes per WP:MOS, MOSCAPS etc.
• Format Citations (source) – Add a link (accessible in the drop-down menu in Vector and as a tab in Monobook) to harmonize whitespace in citation templates, and another to convert them to the vertical format.
  • Tidy Citations (source) – Fork of Format Citations, with slight tweaks. Links appear in the toolbox upon editing, with a choice between vertical tidying and 3 variants of horizontal tidying (crammed, tidy, and roomy).
• Close XfD (source) – Add a link accessible in the drop-down menu in Vector and as a tab in Monobook that adds the appropriate header and footer to close any XfD discussion.

References

Scripts specific to page referencing.

• editRefs (source) – Adds a link to the toolbox which, when clicked, searches the article references and presents them in textboxes for ease of editing. More basic but faster and less intrusive alternative to ProveIt.
• HarvErrors (source) – Displays errors when using Harv templates
• SnipManager (source) – Toolbar with forms to fill in references.
• Sources (source) – Aims for compliance with Help:Citation Style 1, WP:ITALICS: ensures consistency of source names, and general tidying within the reference section.

VisualEditor

• refToolbarVe (source) – adds "cite" option to VisualEditor toolbar for easily adding citations templates within reference.

Vandalism

• rollbackSum (source) – Rollback summary.
• Rollback All (source) – Revert all contributions of a user
• Mass Rollback controlled (source) – Rollback selected contributions of a user or all contribs of a user
• Igloo (source) – Anti-vandal javascript GUI
• No Vandalism (source), a simple script catching edits with Repeating characters filter on them.
• Rollback "in place" (source) – Changes the behavior of "rollback" link: instead of jumping to the diff page, leaves you in the same page. Together with Gadget popup, this can make vandalism-fighting slightly more efficient. In addition, right-clicking the "rollback" link will let you enter a summary, instead of the standard rollback summary.
• Vandal warning toolbox (source) – Quick links to standard warning messages in the Toolbox when editing a user talk page.
• Ajax Undo (source) – Adds an Ajax undo link next to the normal undo link on page histories and on diff pages.
• Ajax Rollback (source) – Turns rollback links into AJAX rollback links.
• Remove Rollback (source) – To disable the rollback feature.

Diffs

• Diff Time (source) – Adds time between diffs and time since each revision.
• Link Intermediate Revisions (source) – Links the "intermediate revisions" message so it can be clicked to see a history listing of those revisions.
• In-place diffs (source) – Adds buttons to each line on the Recent Changes screen, the watchlist, the contributions screen, and article history screens, allowing one to load (and show/hide after loading) an individual diff without moving to another page and view multiple diffs at once.
  •  Note: does not seem to be compatible with AJAX watchlist.
• User History with in-place diffs (source) – Modification of Ale jrb's original UserHist script, which allows filtering of an article's edit history by author name, to add the inline diff functionality, as with the "In-place diffs" script above. (Note that the "In-place diffs" script is not required to use this one, but there is no overlap between the two; this one does not replace the general "In-place diffs" functionality).
• LiveDiffLink (source) – Show a live-updated diff link at the top of History pages while you select revisions, so you don't need to actually load the diff to get a diff link.

User pages

• User Info (source) – Shows user groups, edit count, and time registered.
• Sysop Detector (source) – Shows user rights groups.
• ContribsTabVector (source) – Adds contribs and stats tabs to user and user talk pages.
• Status Changer 2 (source) – Allows a user to quickly change their displayed online status in a couple of clicks.
• Qui (source) – Allows user to change their displayed status in one click.
• StatusChanger (source) – Compatible with the {{UserStatus}} template; allows user to change their displayed status in one click.
• Edit counter (source) – Adds a link to the toolbox to calculate your edits by namespace and write them to a table in your userspace.
  • Completely overhauled version (source).
• Status updater (source) – Click on a status from a list visible to you or everyone to change your status.
• Pages created (source) – Lists all the pages created by a user.

Images

• ImageMapEdit (source) – Adds a tool on image pages that allows the user to create and organize imagemaps much more easily.
• MegapixelDisplay (source) – Displays the number of megapixels (10⁶ pixels) on the image page.
• QuickImgDelete (source) – Tools to make image patrolling easier

Listings

Watchlist

Also see WP:CUSTOMWATCH for a list of possible Watchlist customizations.

• Smart Watchlist (source) – Watchlist customization and organization.
• Watchlist Links (source) – Adds some useful links to your Watchlist.
• Catwatch (source) – Shows the addition of pages to specified categories on your watchlist.
• Interwiki Watchlist (source) – adds interwiki watchlists to your watchlist; supports only a few popular wikis.
• RemoveMarkAll (source) – Completely disables the recent Watchlist and History page changes that highlight updates to pages since your last visit.
• ReverseMarked (source) – Lets you know which watchlist changes you've already checked by fading out viewed items.
• LagToMinutes (source) – When "High database server lag" message shows up, this script displays the total days/hours/minutes/seconds of the lag, in addition to the default total seconds display.
• Watchlist mark (source) – Bolds watched pages in Category and "User Contributions" listings. Also adds a "Show watchlist controls" link to enable watching and unwatching directly from these listings.
• Watchlist scout (source) – Polls your watchlist when you open any Wikipedia page, and then once a minute after that. When it discovers a new, unread page in your watchlist, creates a user-message informing you of the change, and stops polling. The message contains links to your watchlist, to the changed pages, and to their history page.
• Watchlist Notifier (source) – Notification of changes to watched pages. Changes are checked on each page load, with notifications appearing at the top of the page under its title.
• Enhanced RC expander (source) – Automatically expands watchlist/RecentChanges/RelatedChanges links in enhanced RC mode. Also adds a button to collapse all, similar to "Watchlist Links" above, which apparently isn't working currently.
• ajaxWatchlist (source) – Automatically updates your watchlist by displaying new changes as they come in at Special:Watchlist, no reloading necessary.
• Hollis (source) – show a "since last seen" link which gives you the diff of the page since you have last looked at it.

History

• ActiveWatchers (source) – Adds a link to History pages, next to the "Number of watchers" link, to show the number of active users watching the page ("active" defined as users who have logged in within the last 30 days).
• Convert from 24-hour (source) – Changes times in user contributions and history pages to use 12-hour AM/PM clock.
• DynaThank – Hides "thank" links on History pages until you choose to display them.

Categories

• CatListMainTalkLinks (source) – Adds a link to each page's associate Talk: or main page.
• Cat-A-Lot (source) – extremely powerful category editing tool from Commons. Recently this tool learned how to work with regular articles, not just files. this is a wrapper that set the setting variable to enable non-file categorization, and loads the latest cat-a-lot from Commons.

Logs

• New Page Patroller (source) – Adds another box to the sidebar that shows a regularly updated list of new pages

Contributions

• Hide Top Contribs (source) – Does the opposite of the "Only show edits that are latest revisions" checkbox. (There is also an it.wikipedia.org-specific version, which has some "special" problems with some skins, but it still displays somewhere!)
• Convert from 24-hour (source) – Changes times in user contributions and history pages to use 12-hour AM/PM clock.
• Contribs Tab (source) – Adds a contributions tab on user and user talk pages.

Recent Changes

• AjaxRC (source) – Automatically refreshes the Recent Changes every 60 seconds using Ajax.
• Enhanced RC expander (source) – Automatically expands watchlist/RecentChanges/RelatedChanges links in enhanced RC mode. Also adds a button to collapse all, similar to "Watchlist Links" above, which apparently isn't working currently.

Todo lists

• Page Collector (source) – Buttons to add a link to the current page to predefined "todo" list.

WikiProject-specific

• DYK Check (source) – Tool for checking Did You Know eligibility.
• Update Child Lists (source) – Adds a link to the toolbox that instructs a Taxobot to update the child list for a taxonomy template.

Meta-scripts

• ScriptInstaller (source) – An automated installer for Wikipedia userscripts.
• User script sandbox – Allows you to carry out experiments with user JS and CSS code locally – that is, without saving it to your user JS/CSS page first. Does not work in Internet Explorer before version 8.

Non-Vector only

• Edit Count (source) – Adds a quick link in the toolbar for checking one's edit count. (Especially for those who have editcountitis!)
• RC Patroller (source) – Adds a porlet to the sidebar that shows a regularly updated list of recent changes
• EasyBlock (source) – Adds a "block" tab to user pages, contribs pages, and diff pages. Comes with built-in block rationales and expiry times, as well as a "custom block" option. Note: This script works only if you are an administrator.

Libraries

These functions can be included directly in a script but don't do anything unless called by some other code. The functions marked as deprecated have been rendered obsolete by new features added to MediaWiki, and only exist now as wrappers for compatibility with existing code.

(Template)

Documentation	Summary
Add LI menu	Allow "tabs" to be placed in drop-down menus (can be nested). Requires some CSS customisations
warn.js	Gives a prompt to add any template (supposed to be used for warning vandals)
Get user name	Gets the username corresponding to the current page
MD5 2.2-alpha	Calculates the RSA Data Security, Inc. MD5 Message Digest of a string. Supports UTF-8
gui.htmlEdit	A WYSIWYG HTML editing control. See documentation
edit.multiReplace	Class to simplify the replacement of several different regular expressions, each with its own substitution. See documentation
morebits.js	A collection of wiki-related functions (such as editing via the API and displaying Twinkle-style windows), maintained as part of Twinkle (but usable separately)
addToolbarButtons	Add function-calling toolbar buttons. Both the classic and the WikiEditor toolbars are supported (but not the Visual Editor's toolbar).
Value/Selection	Lets you determine the position of the cursor/selection within a text input or textarea box and change the text around it

Snippets

The following code snippets still exist under the now defunct WikiProject User scripts. Many are still in use by live scripts, and they may provide insights for current script developers.

Stylesheets

CSS code in this section is added slightly differently to JavaScript code. The code can be imported by adding {{subst:css|Page_name}} to your monobook.js, or the code can be @imported into your monobook.css. You can just paste the source code if you do not wish to receive updates to the code when it is improved.

Name and link	Purpose	Compatible skins
externals	Replaces the external link icon with the corresponding favicon (works for some links)
VectorButtons	Give those boring gray standard buttons a Vector-like appearance	All
FloatingTOC	Makes the Table of Contents float at the bottom left of the page, so you don't need to scroll back up to the top. See documentation.
accesskey	Display corresponding access keys besides links.
RetroLogo	Replace the top-left Wikipedia logo.