Page semi-protected
Source: Wikipedia, the free encyclopedia.

Mr. Twinkly

Twinkle is a popular JavaScript Wikipedia gadget that allows autoconfirmed users to have many extra options to assist them in common Wikipedia maintenance tasks and to help them deal with acts of vandalism or unconstructive edits. It provides users with three types of rollback functions and includes a full library of speedy deletion functions, user warnings and welcomes, maintenance tags, semi-automatic reporting of vandals, and more. In addition, it gives administrators more tools to help them carry out their duties.

Coolest Tool Award 2019 square logo.svg
2019 Coolest Tool Award Winner
in the category
A screenshot of Twinkle's request for page protection

Quick info

Getting started
To enable Twinkle on your account and receive any future updates automatically, you can simply enable the "Twinkle" gadget in the Gadgets section of your Preferences page. (Don't forget to click "Save" at the bottom of the list of gadgets!)
Customizing Twinkle
To modify many aspects of Twinkle's operation, you can visit
completely clear your browser cache
so your changes take effect.
Getting help
There is comprehensive information about Twinkle at
the talk page. IRC users can connect to the #wikipedia-userscripts or #wikipedia-en
IRC channels.
Reporting bugs or requesting features
You can report bugs or request features on the . Software development is currently slow due to lack of developers and time. As of 2022, tickets take a couple months unless it is a big bug causing lots of disruption.
Contributing code
Twinkle is open source and we welcome code contributions. Twinkle is written in JavaScript, with a linter that enforces ES6 (an old version of JavaScript that we have to use because it is a MediaWiki gadget). If you would like to write code and submit patches to Twinkle, feel free to submit a pull request to our GitHub. Tools you should install on your local machine include Git and npm. You can see a list of easy patch requests here. You can get more details about how to compile and run Twinkle so you can test your changes here. You should test your patch before you open a pull request; we recommend As of 2022, SD0001 and Novem Linguae are the maintainers that approve pull requests.

For a visual demonstration of many of the aforementioned items, it may be useful to view the "Twinkle"

video tutorial on WMF Labs

Documentation and configuration

Before using Twinkle, you should read its documentation to familiarize yourself with its possibilities and functions. Experienced Twinkle users are welcome to expand or improve the documentation based on their use of the tool.


Never forget that one takes full responsibility for any action performed using Twinkle. One must understand Wikipedia policies and use this tool within these policies or risk having one's account blocked. Anti-vandalism tools, such as Twinkle, Huggle, and rollback, should not be used to undo changes that are constructive and made in good faith.

If a change is merely "unsatisfactory" in some way, undoing/reverting should not be the first response. Editors should either make a reasonable attempt to improve the change, or should simply leave it in place for future editors to improve. Undo/revert is appropriate in cases where the contribution is arguably "wrong" (consider moving it to the Talk page), or is unreasonably difficult to fix (e.g. incomprehensible, and the author is unresponsive), or is actually harmful to the article (such as vandalism). A plain language edit summary (not merely tags) should be used when reverting changes that appear to have been made in good faith because many contributors will not recognize minimalistic tags and will not learn what the problem was and are likely to repeat it.

Is Twinkle loading unreliably?

In the past, you could install Twinkle by adding the text importScript('User:AzaToth/twinkle.js'); to your personal script page; however, this practice can make Twinkle load unreliably (Twinkle might not load on every page you visit, or it might show up but not work properly).

To fix this problem, you should remove the line importScript('User:AzaToth/twinkle.js'); from your personal script file, and then turn on the Twinkle gadget using the instructions above.

If you have any old configuration set up using TwinkleConfig or FriendlyConfig, it will still be effective. However, if you use the

preferences panel
to modify your configuration, you are advised to remove all old Twinkle/Friendly configuration variables from your skin JavaScript file.


Twinkle has its origins as a reversion script based on ideas found in Aaron Schulz's script collection. It was developed by AzaToth and released in 2007. It has grown into a tool with many more capabilities than its reversion roots and is used by thousands of Wikipedians. The toolset has expanded over the years: the collection of tools formerly known as Friendly, developed by Ioeth, became part of Twinkle in 2011, and a new module to make user blocking a smoother process for administrators was developed in 2015. Other major contributors include Amalthea, Amorymeltzer, MusikAnimal, SD0001 and This, that and the other. The gadget continues to be updated and improved, in order to accommodate user requests and changes to Wikipedia processes.

Since 5 September 2020, edits and log actions done through Twinkle bear the "twinkle" tag.

Use on other wikis

UPDATE: As of 2021, the twinkle-starter project provides a streamlined way for localising Twinkle to other wikis.

A common request on the Twinkle talk page comes from those who wish to use Twinkle on other wikis. Some parts of Twinkle are easily portable to other MediaWiki-based wikis: the revert/rollback module, for example. But most modules have been designed only with English Wikipedia in mind. For instance, the CSD module relies on templates that most likely do not exist on other wikis.

Users who wish to make Twinkle's functionality available on other wiki projects should consider the following suggestions:

TwinkleGlobal exists as a fork of Twinkle that functions across all WMF wikis. It allows reverting edits, reporting IPs and accounts to SRG, and requesting speedy deletion of pages.

Use on mobile devices

Twinkle is not yet compatible with the mobile skin Minerva Neue. However, someone has written a third party patch that you can install. Please follow the directions at User:Plantaest/TwinkleMobile.


Twinkle users can add any of these userboxes to their user page.

Wikitext userbox where used
{{User Twinkle}}
Police man Twinkle Head.svg
This user contributes with Twinkle.
linked pages
This user is a recent changes patroller with Twinkle!
linked pages
Wikipedia:TwinkleThis user reverts vandalism in the blink of an eye with Twinkle!
linked pages
Police man Twinkle Head.svg
This user reports vandalism in the blink of an eye with Twinkle!
linked pages
Police man Twinkle Head.svg
This user watches over Wikipedia with the help of Twinkle!
linked pages
Police man Twinkle Head.svg
This user performs administrator tasks in the blink of an eye with Twinkle!
linked pages
Chocolate chip cookies.jpg

This user welcomes new users with Twinkle!

linked pages
This user welcomes new users with Twinkle!
linked pages

This user tags articles for maintenance with Twinkle!

linked pages
{{User:Arctic Fox/UBX/Twinkle}}
Peace dove.svg

This user welcomes new users with Twinkle!

linked pages
Chocolate chip cookies.jpg
This user welcomes new users and tags articles using Twinkle.{{tag}}
linked pages

This user tags articles with Twinkle!

linked pages
{{User:me and/Userboxen/Twinkle}}
Police man Twinkle Head.svg
This user maintains Wikipedia with the help of Twinkle!
linked pages
Police man Twinkle Head.svg
This user requests protection to articles with the help of Twinkle!
linked pages
Handshake icon.svg

This user welcomes new users with Twinkle!

linked pages
{{User:CentralTime301/UBX:Twinkle and RC patrol}}
RCPatroller Badge.png
linked pages
Huggle 3 icon.svg
linked pages
{{User:UBX/RW and TW}}

linked pages
Police man Twinkle Head.svg
This person prevents vandalism with Twinkle.
linked pages

Also, there is the Twinkle topicon {{Twinkle topicon}}.