Skip to main content
Version: Next

Using the Email Field

This guide describes how to work with an Email custom field already configured by your administrator. If you still do not see the field on your issue screens, contact your Jira administrator: it may only need to be added to the corresponding screen.

Capture an Email on an Issue​

When the Email field is part of the issue Create or Edit screen, it appears as a simple text field ready for entering an email address.

  1. Open the issue create or edit form.
  2. Locate the Email field (the exact name is defined by the administrator, for example "Requester email").
  3. Enter the email address.
  4. Save your changes.

If the value entered is not a valid address, Jira will show an error message and will not allow saving until the format is correct.

Possible Error Messages​

  • Invalid format: The text does not match a standard email format (for example, missing @, contains spaces, etc.).
  • Too long: The address exceeds the allowed 254 characters.
  • Local part too long: The portion before @ exceeds the allowed 64 characters.

If you receive any of these messages, review the address you are trying to enter and try again.

View an Email on the Issue​

Once saved, the email appears on the issue view as a mailto: link. Clicking it opens your operating system's default mail client with a new message addressed to that email, ready to compose.

This enables quick contact without copying and pasting the address manually.

Search Issues by Email​

You can find issues by Email field value in two ways:

In the Issues view, expand advanced filters and locate the Email field among the available filters. Enter the address to search for and list matching issues.

2. From JQL​

You can also use JQL for more complex queries. For example:

"Requester email" = "client@example.com"

Replace Requester email with the exact name your administrator assigned to the field.

When to Leave It Blank​

If the field is not marked as required in your project, you can leave it blank without any error. Contact your administrator if you have questions about whether the field is required in your context.