|
| 1 | +--- |
| 2 | +title: "Custom Fields" |
| 3 | +path: "/programs/custom-fields.html" |
| 4 | +id: "programs/custom-fields" |
| 5 | +--- |
| 6 | + |
| 7 | +Program administrators can configure custom fields to add data to their reports. This enables your program members to add additional information to your reports to help you better track and manage your internal data by the categories that you define to be important, such as by business unit or by root cause analysis. |
| 8 | + |
| 9 | +> <b>Note:</b> This feature is currently in beta and is only available for select programs. You must be an enterprise program to opt-in to the feature. If you’re an enterprise program and would like to opt-in to the feature, please contact your program manager. |
| 10 | +
|
| 11 | +In this article, you can learn to: |
| 12 | +* [Create a Custom Field](#create) |
| 13 | +* [Fill in a Value for a Custom Field](#fill) |
| 14 | +* [Edit a Custom Field](#edit) |
| 15 | +* [Archive a Custom Field](#archive) |
| 16 | + |
| 17 | +<h3 id="create">Create a Custom Field</h3> |
| 18 | + |
| 19 | +> **Note:** You must be an administrator of the program in order to add a custom field. |
| 20 | +
|
| 21 | +To create a custom field: |
| 22 | +1. Go to **Program > Customization > Custom Fields**. |
| 23 | +2. Click **New Custom Field**. |
| 24 | +3. Enter the **Field Title** on the **Create Custom Field** page. |
| 25 | +4. Select the **Field Type**. You can choose from: |
| 26 | + |
| 27 | +Option | Details |
| 28 | +------ | -------- |
| 29 | +Text | This option enables you to create an editable text field.<br><br> |
| 30 | +List | This option enables you to create a drop-down list that you can select from when editing your custom field.<br><br>Enter your option items in the **Configuration List** field separated by a comma.<br><br> |
| 31 | + |
| 32 | +5. Click **Save**. |
| 33 | + |
| 34 | +All of your reports will now have a Custom Fields section. You can edit the section to add the Custom Field label you created. |
| 35 | + |
| 36 | + |
| 37 | + |
| 38 | +The custom field will also be added into your inbox filter so that you can filter your reports by the custom field you created. (The image below shows the filter 2 custom fields that were created: Squad and Root Cause Analysis) |
| 39 | + |
| 40 | + |
| 41 | + |
| 42 | +<h3 id="fill">Fill in a Value for a Custom Field</h3> |
| 43 | +To fill in a value for a Custom Field to your report: |
| 44 | +1. Go the report you want to add a custom field to. |
| 45 | +2. Click **Edit** in the Custom Fields section. |
| 46 | + |
| 47 | + |
| 48 | + |
| 49 | +3. Enter the information you want to add to the field for each field label. |
| 50 | +4. Click **Save and add fields**. |
| 51 | + |
| 52 | +The information you input will now be tied to your field labels. To edit the information, click **Edit**. |
| 53 | + |
| 54 | + |
| 55 | + |
| 56 | +When you export your reports as a CSV file, the custom field and the information associated will also be included in the export. |
| 57 | + |
| 58 | + |
| 59 | + |
| 60 | +<h3 id="edit">Edit a Custom Field</h3> |
| 61 | +You can edit your custom fields to change the name of the field title. |
| 62 | + |
| 63 | + |
| 64 | + |
| 65 | +To edit the title of a custom field: |
| 66 | +1. Go to **Program > Customization > Custom Fields**. |
| 67 | +2. Click **Edit** for the custom field label you want to edit. |
| 68 | +3. Enter the new title. |
| 69 | +4. (*Optional*) Change the **Field Type** from *Text* to *List*. You can only change the field type from *Text* to *List*. You can’t change a *List type* to a *Text type*. |
| 70 | +5. Click **Save**. |
| 71 | + |
| 72 | +<h3 id="archive">Archive Custom Fields</h3> |
| 73 | +You can archive custom fields that you no longer want to use. We don’t enable you to permanently delete custom fields to prevent data loss. |
| 74 | + |
| 75 | + |
| 76 | + |
| 77 | +To archive a custom field: |
| 78 | +1. Go to **Program > Customization > Custom Fields**. |
| 79 | +2. Click **Archive**. |
| 80 | + |
| 81 | +The archived field can no longer be added to new reports. Current and past reports with the archived field will remain on the report and won’t disappear. You can, however, edit the field within the report. |
| 82 | + |
| 83 | +You can unarchive an archived custom field by clicking **Unarchive**. |
0 commit comments