Documentation Level: 
Documentation Status: 
No known problems

Request new features and report problems in the Backdrop Issue Queue.

Creating new issues

All you need to file a new issue is an account at GitHub. Once you're logged in, navigate to the Backdrop Issue Queue. There's a green button at the top right labeled "New issue". Click that button to get started.

We have provided several issue templates that will help you file your issue. You may browse the list of options here, and select the one that best fits your needs. If you don't see a good match, you can still select the link "Open a regular issue" at the bottom of the list.

When creating your issue, give it a short but descriptive title. Follow the template provided (if applicable), and try to be as detailed as you can. Whenever possible, please include steps we can follow to reproduce the problem you are having. Copy & Paste any error messages you're seeing, and post screenshots if you have them. The more information we have, the faster we'll be able to address your concern.

Once you are satisfied with your issue, click the "Submit new issue" button at the bottom - but don't worry - you'll still be able to edit the issue if you notice a typo.

Commenting on issues

If you have something to add to an existing discussion, don't hesitate to add a comment.  All experience levels are welcome in the issue queue, you don't need to be a developer to tell us what you'd like Backdrop to do, or to do better.

Any time you're interacting with other members of the Backdrop community, please be polite. Even if you are frustrated by misbehaving software, you'll find that you'll get more help faster if you're patient with those who are trying to help you. 

Working on issues

If you are working on an issue in the queue, please assign that issue to yourself. You can do that at the top right of the issue, where it says "Assignees". Once you are done, or if you need to stop working on the issue for any reason, please add a comment at the bottom stating what you have tried, and un-assign the issue from yourself. 

Please create a Pull Request (PR) if you have written code for the issue (it does not need to be in a working state). Some helpful resources:

Once a Pull Request has been created for an issue, please add the label 'status - has pull request' to that issue.  

Issue titles

In some cases you will see characters at the beginning of an issue title in square brackets: [XX]. When these are used, we like to keep them nice and short so that the issue title remains legible. There should only be a few of these in use, with the following meanings:

  • [UX] = User experience. This issue will make Backdrop easier to use. (All accessibility issues should be tagged [UX]).
  • [DX] = Developer experience. This issue will make all types of  coding (theme/module/etc) for Backdrop easier. 
  • [D8] = Drupal 8 feature parity. This issue is for a feature similar to something already included in Drupal 8. 
  • [WP] = WordPress feature parity. This issue is for a feature similar to something already included in WordPress. 
  • [SR] = Security-Related. This issue will make backdrop more secure, or make the people using Backdrop safer.
  • [SEO] = Search Engine Optimization. This issue will improve the way a Backdrop site will rank in search results. 
  • [META] = Meta-issue. This issue has children. It helps us create and maintain hierarchy.
  • [PS] = Performance & Scalability. Resolving these issues will make Backdrop faster and/or more scalable.