# Usage

> **This app only works with Company-managed (formerly Classic) project.**

## Creating a new custom field

Please follow the instructions by Atlassian [https://support.atlassian.com/jira-cloud-administration/docs/create-a-custom-field/](https://support.atlassian.com/jira-cloud-administration/docs/create-a-custom-field/) to create a custom field of the type **Table Custom Field**. The following screenshots summarize key steps. There might be differences between Jira instances and Jira Cloud versions.

Navigate to the **Settings** screen.

<figure><img src="https://3588362646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma7ua4NoSptEMaVrDMS%2Fuploads%2FINBpONc4c6z87pP8vlCG%2Fimage.png?alt=media&#x26;token=662a65ec-f798-4947-b76a-436ad1369595" alt=""><figcaption><p>Table Custom Field for Jira</p></figcaption></figure>

Select the **Custom fields** page.

<figure><img src="https://3588362646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma7ua4NoSptEMaVrDMS%2Fuploads%2Fu4T0SLRpsUz0RiCxP9eF%2Fimage.png?alt=media&#x26;token=31abbd2c-f582-47c0-a441-662f26c48822" alt=""><figcaption><p>Table Custom Field for Jira</p></figcaption></figure>

Click **Create custom field.** Select the **All** menu. Search for the type **Table Custom Field.** Select and click **Next**.

<figure><img src="https://3588362646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma7ua4NoSptEMaVrDMS%2Fuploads%2FnaCK2Qthsw27XoRqSbPX%2Fimage.png?alt=media&#x26;token=b291d5b5-bf21-4140-986b-ec4ee79db785" alt=""><figcaption><p>Table Custom Field for Jira</p></figcaption></figure>

The custom field will be created.

<figure><img src="https://3588362646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma7ua4NoSptEMaVrDMS%2Fuploads%2FLgKuzblbsrZ8yg7ANoBy%2Fimage.png?alt=media&#x26;token=db2c3591-3107-460e-9001-2cbff74f51b8" alt=""><figcaption><p>Table Custom Field for Jira</p></figcaption></figure>

## Configuring table columns

Please follow the instructions by Atlassian [https://support.atlassian.com/jira-cloud-administration/docs/configure-custom-field-context/](https://support.atlassian.com/jira-cloud-administration/docs/configure-custom-field-context/) to edit a custom field's context. The following screenshots summarize key steps. There might be differences between Jira instances and Jira Cloud versions.

Click on the **1 context** link.

<figure><img src="https://3588362646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma7ua4NoSptEMaVrDMS%2Fuploads%2FxsXAqZxpxDurCuvaI23a%2Fimage.png?alt=media&#x26;token=2f1bf800-6e85-46ad-83d7-93a1f2276154" alt=""><figcaption><p>Table Custom Field for Jira</p></figcaption></figure>

Click **Create, edit or delete contexts**.

<figure><img src="https://3588362646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma7ua4NoSptEMaVrDMS%2Fuploads%2FkXmdWvi9yoQ40D9yaQiY%2Fimage.png?alt=media&#x26;token=d5d5c10e-ac5e-4ce8-bb06-945d022ec29e" alt=""><figcaption><p>Table Custom Field for Jira</p></figcaption></figure>

Click on **Edit custom field config**.

<figure><img src="https://3588362646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma7ua4NoSptEMaVrDMS%2Fuploads%2FLkkc4EKhfbLGeKIYH5kX%2Fimage.png?alt=media&#x26;token=f4a76678-2f21-4917-ba71-11f81958629a" alt=""><figcaption><p>Table Custom Field for Jira</p></figcaption></figure>

Provide the configuration of columns in the table.

<figure><img src="https://3588362646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma7ua4NoSptEMaVrDMS%2Fuploads%2FLiK86q06RKRGIIrl0rKo%2Fimage.png?alt=media&#x26;token=e0125f74-a675-4edf-a6a4-a081ed0c13ff" alt=""><figcaption><p>Table Custom Field for Jira</p></figcaption></figure>

## Enabling the table custom field on the issue page

Click on the **Tables** button on the toolbar.

<figure><img src="https://3588362646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma7ua4NoSptEMaVrDMS%2Fuploads%2FfXvdScL3HTI3ELCzkLYi%2Fimage.png?alt=media&#x26;token=2462a3dc-cdbd-45be-885d-ab5ef2714604" alt=""><figcaption><p>Table Custom Field for Jira</p></figcaption></figure>

Click on the **Allow access** button.

<figure><img src="https://3588362646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma7ua4NoSptEMaVrDMS%2Fuploads%2FfMjW54sLw44YoVobeTCL%2Fimage.png?alt=media&#x26;token=a3973b90-fc11-4754-b064-f64d8ec021e1" alt=""><figcaption><p>Table Custom Field for Jira</p></figcaption></figure>

Click on the **Accept** button.

<figure><img src="https://3588362646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma7ua4NoSptEMaVrDMS%2Fuploads%2FbVyi9zd7bRYwd4E0wP57%2Fimage.png?alt=media&#x26;token=e4a212f1-48a3-4bbf-9361-0a410a1ce3f0" alt=""><figcaption><p>Table Custom Field for Jira</p></figcaption></figure>

The table is shown.

<figure><img src="https://3588362646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma7ua4NoSptEMaVrDMS%2Fuploads%2FvB3gTq94H0x3FvvHcdI4%2Fimage.png?alt=media&#x26;token=99156b1b-bb39-449a-a069-06582d22f759" alt=""><figcaption><p>Table Custom Field for Jira</p></figcaption></figure>

## Working with tables

Hover on the table and click on the **Edit** button. The table will switch to the edit mode.

<figure><img src="https://3588362646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma7ua4NoSptEMaVrDMS%2Fuploads%2FpMMcGVzIzcOIYJmuDkWv%2Fimage.png?alt=media&#x26;token=de7c1f11-50c5-4884-8122-8e43a3553630" alt=""><figcaption><p>Table Custom Field for Jira</p></figcaption></figure>

To add a row, click on the **Add** ("plus" icon) button.

<figure><img src="https://3588362646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma7ua4NoSptEMaVrDMS%2Fuploads%2Fl5En1PeQFGHKHJrj1mea%2Fimage.png?alt=media&#x26;token=c1769f5d-aea8-4dd9-8764-1537e7db373a" alt=""><figcaption><p>Table Custom Field for Jira</p></figcaption></figure>

To edit a cell, hover on it and click the **Edit** ("pencil" icon) button. Use Markdown format for the content.

<figure><img src="https://3588362646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma7ua4NoSptEMaVrDMS%2Fuploads%2FITJyZwOcH6oKtkBpu2hB%2Fimage.png?alt=media&#x26;token=08a552c6-8d89-44c0-8030-b682ef8dafbb" alt=""><figcaption><p>Table Custom Field for Jira</p></figcaption></figure>

To remove a row, select the row by clicking on the checkbox, and click on the **Remove** ("recycle bin icon").

<figure><img src="https://3588362646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma7ua4NoSptEMaVrDMS%2Fuploads%2FmhdtUL5EgC6Zle5XK4TR%2Fimage.png?alt=media&#x26;token=8e38d6bf-c2f6-4e31-9ed5-6e315c733682" alt=""><figcaption><p>Table Custom Field for Jira</p></figcaption></figure>

To reorder rows, drag and drop rows with the "six dots" icon.

After editing, click the **Save** button.
