---
title: "Time to SLA custom field"
canonical: "https://support.appfire.com/space/TTS/46465168/Time%20to%20SLA%20custom%20field"
format: markdown
---
> Macro (aura-html)

The Time to SLA custom field helps you track SLAs by displaying a countdown to the remaining duration or overdue time if an SLA is breached. It uses colors and icons to show the status of an SLA.

![image](media://15f0fbaf-4091-4970-abe7-5b101c15ebd0)

> ℹ️ To learn how to create the custom field and add it to the necessary screens, follow [this guide](https://appfire.atlassian.net/wiki/spaces/TTS/pages/46727443/Custom+fields#Step-1%3A-Create-an-SLA-custom-field).

## Colors and icons

Take a look at the table below to grasp the meaning of each color you may see on the custom field:

| **Description** | **Color and icon** |
| --- | --- |
| The SLA has not STARTED. | ![image](media://0b55a919-e327-4345-abbf-ae5c22ca750c) |
| The SLA is in PROGRESS. *(before critical zone)* | ![image](media://221e6271-bfef-45fe-ac71-d573819ca1b8) |
| The SLA is in PROGRESS. *(after critical zone)* | ![image](media://c92930c6-f32f-4c35-87b3-b164756b45e3) |
| The SLA is EXCEEDED. | ![image](media://325b13fc-fa69-46af-b87d-e218f02a68a5) |
| The SLA is COMPLETED. | ![image](media://2a7c9e4f-f2f2-4f31-be8d-9d6eabea4da1) |

> ℹ️ The Time to SLA Custom Field shows separate fields per SLA if an issue meets more than one SLA.

![image](media://7f380f9e-c263-44ed-ae88-94fab82ae6ad)

---

## How to configure Time to SLA custom field display options

1. Go to **SLA Fields**.
2. Click the cog icon in the row of a custom field in order to change its display options.
3. Click **Display Options** from the dropdown menu. The *Display Options* screen appears.
4. Select **Time Format **to display. In the preview below the *Time format* section, you can see the **Sample Time String **as you select.
  - **Long format:** Displays the duration with day/hour/minute/second units and full localized unit labels.
  - **Short format:** Displays the duration with day/hour/minute/second units and abbreviated unit labels.
  - **Shorter format:** Displays the duration with hour/minute/second units and abbreviated unit labels.
5. Tick **Display SLAs of Linked Issues **if you want to view SLAs of linked issues within one another.
6. Select when to display SLA names in the custom field.
7. Tick **Show Completed SLAs **if you want to see completed SLAs in the custom field.
8. Click **Save.**

---

## How to use Time to SLA custom field in Groovy Script

1. Select **Time Format **to display. In the preview below the *Time format* section, you can see the **Sample Time String **as you select.
  - **Long format:** Displays the duration with day/hour/minute/second units and full localized unit labels.
  - **Short format:** Displays the duration with day/hour/minute/second units and abbreviated unit labels.
  - **Shorter format:** Displays the duration with hour/minute/second units and abbreviated unit labels.
2. Tick **Display SLAs of Linked Issues **if you want to view SLAs of linked issues within one another.
3. Select when to display SLA names in the custom field.
4. Tick **Show Completed SLAs **if you want to see completed SLAs in the custom field.
5. Click **Save.**