Bugzilla



All bugs in the MediaWiki software should be reported at bugzilla.wikimedia.org. This is also the place to request new features or enhancements to the software.

What is Bugzilla?
For more information, see the Wikipedia article on Bugzilla.

Bugzilla is an online bug-tracking tool, developed by the Mozilla Foundation, and is the system we use to track all open issues with MediaWiki.

The reason we use Bugzilla is that it allows the developers to easily find, track and discuss issues, to spot duplicates and ultimately to resolve them.

Wikimedia's bug tracker is usually referred to as "BugZilla". Older references may call it "MediaZilla".

Reporting a bug

 * 1) Go to bugzilla.wikimedia.org.
 * 2) Use the search box on the main page to see if your bug has already been submitted.  You can also perform more advanced searches on the search page.
 * 3) If you are sure that your issue has not already been reported then click enter a new bug in the toolbox on the left.  You will be prompted to log in if you have not already done so (see 'Why must I register?', below).
 * 4) Select 'MediaWiki' as the product.
 * 5) Fill in at least the following fields (the for rest, check Bugzilla/Fields):
 * 6) * Component (if you don't know, select 'General/Unknown')
 * 7) * Summary - a short one-sentence summary of the issue
 * 8) * Description - full details of the issue, giving as much detail as possible. Describe only one (1) issue.
 * 9) Click "Commit"

That's it! For maximum chance of your bug being fixed, you are advised to read the bug writing guidelines first.

See also: How to Report Bugs Effectively by Simon Tatham

Requesting a feature
Before making a feature/enhancement request:


 * Consider whether a custom extension would be more appropriate. If an extension makes sense and if such an extension does not exist yet (see the list of extensions), file a request under MediaWiki extensions→Extensions requests.
 * If the request is specific to a Wikimedia wiki and an extension exists already, please discuss the issue on that wiki first (e.g. on the Village Pump of your wiki or any other appropriate place). Developers will usually ask you for a link showing a community consensus.

Then follow the same directions as above, except you will need to file the report under 'Wikimedia→Extension setup' or 'Wikimedia→Site configuration'. Please also mention the specific wiki and its language in the bug report.

Comments
Bugzilla comments are plain text, you cannot use HTML. However, Bugzilla will automatically make hyperlinks in these ways:

Link to:
 * Bug report:
 * Comments: . Can also be combined with bug:
 * Attachments:
 * SVN commits: (link to the revision shown in Code review (through Special:Code/MediaWiki)
 * Change sets in Gerrit: See also 35144. The current recognized syntax is this: , situation evolving.

More info: Hints and Tips. From The Bugzilla Guide. Go there for latest version.

Full URLs
Websites:

MediaWiki-style internal links
They are supported. By default they point to English Wikipedia. Interwiki prefixes are supported as well and work as usual, starting from en.wikipedia.org: will link to the German Wikipedia, and so on.

Using pipes for a different label does not work. For example;  is not supported and won't create a link.

Section links work too, but you need to insert them correctly: the simplest way is to copy the URL from the location bar of your browser, and add brackets around the part of it after wiki/, e.g. to link MediaWiki (technically: the section link has to be already URL-encoded).

Longer interwiki links need to be on their own line, otherwise they're split over two lines and won't be linkified. If an interwiki link is not recognized, add a colon : before it (e.g. ).

Since recently, also non-local interwikis work.

Why must I register?
We need you to register in order to use Bugzilla. This is primarily so that we can contact you if there are further questions regarding your bug submission. For example, if a developer is unable to replicate your problem they will ask for more information. By default you will get e-mail notifications when there is activity on your bug reports.

You can also add/remove yourself from any bug report (including reports created by other users).

You can change your preferences to specify when Bugzilla should (and shouldn't) send emails to you. To change your preferences, log in on Bugzilla and click on your emailaddress at the top right of the page.

How do I register?
Registering is simple and free. Click the "create account" link at the top right of the page, enter your e-mail address (and optionally your real name) and click "create account". Then simply log in using the password you receive in the confirmation e-mail (which can be changed in your preferences once you have logged in). When logging in enter your email address in the login form on any Bugzilla page.

Note that new users are prevented from taking certain actions by default, such as closing or assigning tickets. This is largely to protect against spam. You can acquire these rights by participating in the tracker in other ways, or by requesting them on IRC.

How to hide your email address
Please note that (unlike on Wikimedia projects) your email address will be visible on threads you participate in, and on thread CC lists you have added yourself to. It is visible to everyone who is logged in. It is not visible to people who are not logged in. Your email address can not be hidden from logged-in readers. It is possible to create an additional web-based e-mail address, and then set it to forward email to your main email address. This prevents exposure of your main email address. Google Mail (Gmail) allows free email forwarding. One can automatically forward email from one Gmail account to another Gmail account, or to any email account. You can change your email address or name at anytime on Bugzilla. They are then changed in all bug threads you participated in. So if you decide later on to hide your main email address or name you can still do so.

Why can't I report bugs on the wiki?
You can. You can also report bugs by writing them in chalk on the pavement. However, if you want a developer to act on it then you need to put it somewhere they are likely to see it, namely Bugzilla.

How do I link to a bug?
If you want to create a link from a wiki page to a Bugzilla report, use, where XXX is the number of the bug report. For example will result in the following link: 4198. You can also use the bugzilla template, for example will result in. In some wikis, you can use, and also  when the bug report has been marked as fixed.

What do the priority and severity fields mean?
See Bug management/Bugzilla usage and Bug management/Bugzilla usage.

What does the Status field mean? (NEW, RESOLVED, etc.)
See the field description. NEW is also one of the statuses that an open bug might have.

Queries

 * List open Bugzilla tickets by number of votes