Customer PortalAPI DocumentationGo to Atlas

No results

Help CenterDataCustom fields

Custom fields

Last updated March 4, 2025

Custom fields

What are custom fields?

Custom fields let you add extra information to your tickets in Atlas. This helps you organize your support work in a way that makes sense for your team.

Creating a custom field

To make a new custom field, go to “ App Configuration > Data > Custom Fields ”. Click 'Add ticket field'.

You'll need to fill in some information:

Custom fields

Label

This is what everyone will see. It's the name of your field.

Key

This is for developers to use when setting up the field.

Edit access

Choose who can change this field. It could be just admins or developers using the API.

Description

Explain what the field is for.

Types of fields

You can create different types of fields, like dropdown menus or text boxes. Some fields can be required before a ticket can be closed or moved to a new state.

Making fields work together

You can make fields depend on each other. For example, you could have an 'Outreach Category' field with choices like 'Bug' and 'Payment'. Then, you could have a 'Sub-criteria' field that changes based on what's selected in 'Outreach Category'.

Custom fields

To do this, you'd set up a conditional script. It might say: If 'Outreach Category' is 'Bug', then 'Sub-criteria' should only show 'Log' and 'Error'. If 'Outreach Category' is 'Payment', 'Sub-criteria' would show different options.

Showing fields on tickets

You can choose which custom fields show up on each ticket. Go to the info pane settings to set this up. You can make some fields always show, even if they're empty. These 'always show' fields will also appear in notifications sent to agents.

Using custom fields for other things

Custom fields are great for setting up automated workflows and making reports. They help you sort your tickets in ways that make sense for your team.

Custom fields in notifications

The fields you set to 'always show' will be included when agents get notifications, like in Slack. This helps agents quickly see important information about a ticket.

Why use custom fields?

Custom fields let you:

  • Add information that's important for your team
  • Set up your support process in a way that works for you
  • Give agents the right information at the right time
  • Make better reports about your support work

By setting up custom fields that work for your team, you can make your support process smoother and more effective.

Was this article helpful?