Regex: Create and configure Regular Expression custom field

Regex custom field is used to validate the values entered into the field - it can be used on the create issue screen and also on the customer portal.

Regex custom field is only a text field.

👀 Learn with an interactive demo

How to configure Regex custom field?

To create a Regex custom field, you need to have global permissions.

1. Go to the Issues in global settings and to the Custom Fields section.

2. Create a new custom field and find it in the Advanced section "Regex".

3. Associate custom fields with the projects and screens you need.

This custom field works with every kind of project.

1. In the already created custom field, choose Context -> Create, edit, or delete contexts -> Edit custom field config.

2. Now, let's configure Regex values. Use Templates or enter your pattern. Examples of use are here.

3. Define an error message that will be displayed when a user enters an incorrect data format. If the field remains empty, a default message will be: "Enter a value that will be validated for the configured regular expression: [regex_pattern]."

4. At the bottom, there is a testing area where you can run a data validation test. We always recommend running a test.

5. Save the field.

How to add a Regex custom field to the project?

a) Company-managed project

To add a custom field in a company-managed project, you can do it from the custom field level with Screens and context and then add or remove the associated screen.

You can get the same result by adding a custom field to the list in Screens options on the left menu in Issue global settings.

⚠️ To add a custom field to the company-managed project, you must be a global admin.

b) Team-managed project

In a team-managed project, go to the project settings -> issue types -> Search for field -> and add a custom field where needed.

⚠️ You can do it as project admin.

Regex Templates available

Template title	Description
Credit card validator (Mastercard)	Example: 2222 4053 4324 8877
Date format	Example: 12/07/2024
Email address	Example: [e-mail]
HEX color	Example: #F5007E
IBAN	Example: DE89 3704 0044 0532 0130 00
IPv6	Example: 2001:0000:130F:0000:0000:09C0:876A:130B
LinkedIn profile	Example: linkedin.com/in/john-doe/
MAC address	Example: 00:B0:D0:63:C2:26
Name and surname	Example: John Doe
SWIFT code	Example: AAAA-BB-CC-123
US Phone number	Example: [phone]
US Postal code	Example: 33138
USD currency	Example: $350.75