Help:Bots

A bot is a piece of software that makes automated edits on a community and also helps human users to make semi-automated edits. Bots are most often used to make repetitive edits to many pages, such as moving a group of pages to a new category, fixing links to disambiguation pages, or to search for misspelled words and replace them with correct ones.

Bot flags
As bots can make many edits during their run, their edits can overwhelm the recent changes list, making it difficult to see and respond to edits by human users. For this reason, bots that have been tested and approved by a community can be given a bot flag. A bot flag is a setting in the MediaWiki software that hides bot edits from the recent changes list. Bot edits can always be revealed by clicking "Show bots" in the Recent changes header.



How can I flag an account as a bot?
Please contact Fandom staff to request a bot flag for a specific account. Your request should include a link to a public discussion on your community or explicit permission from a bureaucrat, showing approval of the use and flagging of the bot. A bureaucrat can also contact staff and request to flag accounts as bot. On certain communities, bureaucrats are also able to flag themselves and other users as bots often for cleanup purposes or testing.

Important notes
Bots on Fandom must use a limited editing rate so that they don't overload Fandom's servers. For most bot programs, a rate throttle is built in, so you don't need to worry about this. However, if you find your bot making more than one edit per second, then it's time to slow it down. A bot account's user profile and talk page should:
 * Clearly identify the account as a bot
 * Link to its owner's user talk page for questions
 * Encourage users to have the bot blocked by an admin if its automated edits are causing damage to the community — the block can be lifted after the causes for the damaging edits are understood and fixed.

Check page
AutoWikiBrowser (AWB) makes use of a whitelist called a "check page". On Fandom, if this page exists locally on the community (in the format of Project:AutoWikiBrowser/CheckPage), the bot's username (or the username the bot will run on) will need to be on this check page in order to operate on the wiki. If the check page does not exist, there is no restriction and AWB can be run without requiring the whitelist. This is done to restrict unauthorized bot programs from being run on communities.

Using Special:BotPasswords
Bots can log into external tools using their normal username and login for legacy wikis. But if you want to edit on a UCP wiki, you'll need to generate BotPassword for these tools to use instead. Bot passwords give selective permissions to these tools that you can revoke if the password is lost or compromised.


 * 1) Log in to any UCP wiki via the regular web interface, using the account under which you want your bot edits to show up. Users with separate accounts for web editing and bot editing should log in via their bot account, rather than the one they use for normal web editing.
 * 2) Navigate to Special:BotPasswords
 * 3) Fill in a "Bot name". For example:   if the password is for logging into AWB. This name will be added as a suffix to your currently logged-in username, for example:.
 * 4) Select the desired permissions for this bot login. ,  , and   should be sufficient for most bot tasks.
 * 5) * Note: You can only successfully grant permissions that your web account already has. For example, attempting to grant the "delete pages" permission and then using these bot credentials to edit a wiki where your web account is not an administrator or above will not actually grant your bot the ability to delete pages at that wiki.
 * 6) Click "Create".
 * 7) The bot username and generated password are displayed. This password will only be displayed on this page. Once you navigate away from this page, the password will not be retrievable.
 * 8) * If you ever lose your password, you can return to Special:BotPasswords to create a new password.

Resources
For more information on using and making bots, see AutoWikiBrowser, Pywikibot, or Creating a bot.

Please visit the Community Central Forum to find other bot users for help in using bots for specific tasks.

User blogs on bots

 * TimmyQuivy — Bots: An Overview Of How They Are Used on Fandom
 * RansomTime — An Introduction to AutoWikiBrowser
 * RansomTime — An introduction to Pywikipediabot
 * TyA — Pywikipedia
 * TheGoldenPatrik1 — Basic Script-Based Bots

Further help and feedback
ca:Ajuda:Bots de:Hilfe:Bots es:Ayuda:Bots fr:Aide:Robots it:Aiuto:Bot ja:ヘルプ:ボット nl:Help:Bots pl:Pomoc:Boty pt:Ajuda:Bots ru:Справка:Боты tr:Yardım:Botlar uk:Довідка:Боти zh:Help:機器人