Jira

Want the overview first? See the Jira integration overview.

How to set up

Configuration is per-project in Ybug. To integrate your project with Jira, go to your dashboard and follow these simple steps:

1. Go to the Integrations section in your project settings.

2. Click the On/Off switch in the Jira row.

3.1 Enter the entire URL of your Jira instance (i.e. https://jira.acme.com:8080 for self-hosted Jira Server or https://acme.atlassian.net for Jira Cloud).

3.2 Enter your username and your API token and click the Authenticate button. (Jira Server does not support authentication using API tokens — use your password instead.)

TIP

It is recommended to create a new Jira user for the Ybug integration with limited permissions. If you use Jira Cloud, you have to use an API Token instead of your password — see How to generate API Token?

4. Choose a project, issue type and optionally a default assignee, then click the Save settings button. You can test the integration by clicking the Test button — Ybug will try to send a sample report using settings in the form.

Advanced settings

Task title

You can adjust the task summary field format to better adhere with your current workflow. The default task title format is [{{project.name}}] #{{report.id}} {{report.title}}, and you can compose your own from placeholders such as {{report.priority}} or {{report.user.email}}. See Title format for the full list.

Task description

It is also possible to adjust what information will be included in the task description, from the page URL and the reporter to browser, screen size and custom user data. See Forwarded data for all the options.