Skip to main content
Version: 1.0.0

Using the Email field

This guide describes how to work with an Email custom field that your administrator has already configured. If you don't see the field on your issue screens yet, check with your Jira administrator: most likely it just needs to be added to the right screen.

Capture an email on an issue​

When the Email field is part of the Create, Edit, or Transition screen, it appears as a text field ready to accept an email address.

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

If the value isn't a valid address, Jira will show an error and refuse to save until the format is correct.

Possible error messages​

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

If you see one of these messages, double-check the address and try again.

Inline editing from the issue view​

On the issue detail view you can change the email without opening a full form:

  1. Click the field's value.
  2. A text input appears with the current value.
  3. Edit the address.
  4. Press Enter or click outside the field to save. Press Esc to cancel.

If you enter an invalid value, the field stays open showing the error until you correct the address or cancel the edit.

Viewing an email on an issue​

Once saved, the email appears on the issue as a mailto: link preceded by an envelope icon. Clicking it opens your default mail client with a new message addressed to that address, ready to write.

This makes quick contact easy without copying and pasting the address.

Searching issues by email​

You can find issues by the Email field value using JQL:

"Requester email" = "user@example.com"
"Requester email" is not EMPTY
"Requester email" in ("user@example.com", "support@example.com")

Replace Requester email with the exact name your administrator gave the field.

Partial-text search is not available

The ~ and !~ operators (partial match) are not compatible with this field type on Jira Cloud due to a Forge platform limitation. Use exact match (=) or lists (in) instead.

Leaving it blank​

If the field is not marked required in your project, you can leave it blank without error. Check with your administrator if you're unsure whether the field is required in your context.