How to report a Joomla! bug

If you come across a Joomla! bug, you can report it to Joomla!’s developers using the Joomla! Issue Tracker. Reporting bugs helps to make Joomla! an even better application than it already is.

Creating a GitHub account

If you don’t already have one, you will need to create a GitHub account before you can report a bug in Joomla! Issue Tracker. Creating a GitHub account is easy and doesn’t cost anything if you select the Free plan.

Create the account

To create your account, go to the GitHub sign up page and follow the instructions on the screen. To get a free account, select the Free plan.

To create a different type of account or learn more about GitHub accounts, go to Signing up for a new GitHub account.

Verify your email address

To finish creating your GitHub account, you must verify the email address you provided when you signed up. When you receive the verification email, click the Verify email address link. When the GitHub login screen appears, log in to your account to make sure everything is working as it should.

Logging in to Joomla! Issue Tracker

Once you’ve created and verified your GitHub account, you can log in to Joomla! Issue Tracker. To start, open Joomla! Issue Tracker in your browser.

Joomla! Issue Tracker Login

On the Issue Tracker menu, click the Login with GitHub button. On the next screen, sign in using your GitHub Username or email address and your Password.

If this is your first time logging in, you should see the Authorize Joomla! Issue Tracker screen. To continue, click the Authorize Joomla button.

Authorize Joomla! Issue Tracker

You should now be logged in to Issue Tracker and see a New Item button and an Account dropdown on the menu.

Report a Joomla! Bug - Log in to Issue Tracker

Reporting the Joomla! bug

To report the Joomla! bug, you will create a new Issue Tracker item. Before you do, it’s a good idea to search for the bug to make sure it hasn’t already been reported.

Search for the bug first

To search for the bug, make sure the toolbar’s Open button on the toolbar is selected, then click the Search Tools dropdown.

Search Joomla! Bug

Unless you know your way around Issue Tracker, you can ignore most of the search filters. Your best bet is to choose some keywords that describe the bug and enter them in the Filter list by ID, summary, or description search box. To start the search, click the Search icon or press ENTER.

If after a few tries you still don’t see a matching bug, go ahead and create a new Tracker item for it.

Create the new tracker item

To create the new item, click the New Item button on the Issue Tracker menu. You should now see the New Item screen.

Submit New Joomla! Bug

To display instructions right in the New Item form, set the View Mode toggle in the upper right-hand corner of the form to Help.

Enter a Title and Description for the bug following the instructions in the blue boxes below. To upload and attach any notes or screen images to the item, click the Add files button at the bottom of the form and follow the on-screen instructions. To finish entering details of the bug, select a Priority and one or more Categories in the box to the right of the form. If you know your version of Joomla!, enter it in the Build field. Again, follow the instructions in the blue boxes. When you’re finished entering all the details, click the Submit button.

Getting more help

To get more help, take a look at the Filing Bugs and Issues page in the Joomla! documentation.  To see what a detailed, well-written bug report looks like, scroll down the page to see the examples provided.

For further questions, or if you need help, please open a support ticket from your HostPapa Dashboard. Follow this link to learn how.

Related Articles