Reporting Bugs

Reporting Security Issues

While we try to be proactive in preventing security problems, we do not assume they’ll never come up. If you believe you’ve found a security problem in a release of WordPress, please see the Security FAQ for information on how to report the problem.

It is standard practice to notify the vendor (the WordPress security team, in this case) of a security problem before publicizing, so a fix can be prepared, and public damage due to the vulnerability minimized.

Top ↑

Overview of Bug Reporting and Resolution

There are many steps in the process of reporting and resolving a bugbug A bug is an error or unexpected result. Performance improvements, code optimization, and are considered enhancements, not defects. After feature freeze, only bugs are dealt with, with regressions (adverse changes from the previous version) being the highest priority. in WordPress. Here is an overview:

  • A user finds a bug that appears to be in the coreCore Core is the set of software required to run WordPress. The Core Development Team builds WordPress. of WordPress (not a theme or a pluginPlugin A plugin is a piece of software containing a group of functions that can be added to a WordPress website. They can extend functionality or add new features to your WordPress websites. WordPress plugins are written in the PHP programming language and integrate seamlessly with WordPress. These can be free in the Plugin Directory or can be cost-based plugin from a third-party).
  • The user confirms it is actually a bug which has not yet been reported.
  • The user submits a bug report, called a ticket, to Trac, the WordPress Bug Tracker.
  • A WordPress developer (who is a volunteer, like you) confirms that the bug does actually exist, and that it should be fixed, and comments as such.
  • A WordPress developer (which could be you) decides to fix the bug. The developer figures out how to fix the bug, create a patchpatch A special text file that describes changes to code, by identifying the files and lines which are added, removed, and altered. It may also be referred to as a diff. A patch can be applied to a codebase for testing., and uploads the patch to TracTrac An open source project by Edgewall Software that serves as a bug tracker and project management tool for WordPress..
  • Members of the WordPress development community test the patch to see if it fixes the bug, and doesn’t break anything else. They may also run Automated Tests against the bug and patch, and write new tests (or suggest new tests be written).
  • One of the WordPress developers with authority to modify the official WordPress source code commits the patch to the core code in the SVNSVN Subversion, the popular version control system (VCS) by the Apache project, used by WordPress to manage changes to its codebase. repository. They are more likely to do this if the bug and patch has been verified by someone they trust – WordPress development operates largely on a system of trust and merit.
  • The person who commits the patch closes the bug as fixed.

Top ↑

Before You Report a Bug

With large projects like WordPress, so many users report bugs that there’s a good chance your bug has already been reported. Because of this, it’s very important to check to ensure it’s not already in the system before you submit it. If you are new to reporting bugs in WordPress, it is also a good idea to discuss the issue with more experienced developers before reporting it.

1. Make sure the bug is actually caused by WordPress core.

Just because an error message points to a core file, doesn’t mean that’s where the problem is. You may want to use a plugin like Debug Bar to track down the problem. A simple script like this debugging file could help you see where exactly the error is coming from. (You can place this file in your wp-content/mu-plugins directory; create it if it doesn’t exist.)

Another key strategy is to try and replicate the bug in a fresh WordPress install with no extra plugins or themes. While this may not always be possible, if you can find it in a fresh install, the issue is much more likely to be in core.

2. Search for your bug or enhancementenhancement Enhancements are simple improvements to WordPress, such as the addition of a hook, a new feature, or an improvement to an existing feature. request.

  • If your issue has already been reported, please do not report a duplicate bug. If you have further information to contribute, add a note to the existing bug.
  • If your issue is similar, but not quite the same as another issue, you may decide whether to add a note to the similar issue, or report a new one. In general, if you just have more information to contribute to a current, open issue, simply add a note to that issue. If you have a different enough issue, or if you are experiencing a recurrence of an issue that was previously resolved, report a new bug. Either way, core contributorsCore Contributors Core contributors are those who have worked on a release of WordPress, by creating the functions or finding and patching bugs. These contributions are done through Trac. will offer you guidance once you’ve posted about your issue.
  • If your issue was recently reported and then closed, and you do not agree with the resolution, you can still post comments as to your reasoning.
  • It is best not to re-open bugs that have been closed for some time. If the bug was closed as fixed for a version of WordPress that has been released already (see the Milestone field), open a new ticketticket Created for both bug reports and feature development on the bug tracker..
  • The Version field relates to the version in which the bug was originally discovered. If you’re seeing the same bug in a newer version, mention so in a comment, but please do not change the version number.

3. Consider discussing a possible bug before reporting it.

Top ↑

Reporting a Bug

Trac is the name of the official WordPress bug tracker. It uses the open sourceOpen Source Open Source denotes software for which the original source code is made freely available and may be redistributed and modified. Open Source **must be** delivered via a licensing model, see GPL. bug tracking software Trac, by Edgewall Software. To learn more about Trac, see The Bug Tracker (Trac). To create a good bug report:

  1. Read the section above about what to do before reporting a bug.
  2. Log onto WordPress Trac using your support forum username and password. If you don’t have an account at the support forums, you can register.
  3. Click New Ticket in Trac to reach the bug reporting page.
  4. Fill in the title, summary, and other fields. For more, see the section on Ticket Properties.
  5. Click Submit Ticket after previewing it.

Your involvement doesn’t end after you’ve submitted a ticket. Developers may need more information as they review the ticket (and may specifically request more information from you by tagging the ticket with reporter-feedback).

You can also help by verifying that proposed fixes solve the problem you were experiencing. The processing of your bug may require your participation, so please be willing and prepared to aid the developers in resolving the issue. If you’d like to help fix the bug, see the section on Fixing Bugs.

You will be automatically emailed when your tickets are updated if you’ve entered your email address in your Trac preferences.

Last updated: