---
sourceDocument: Zurich Strategic Portfolio Management
sourceDocumentLink: https://www.servicenow.com/docs/r/zurich/it-business-management

 Release :

    - zurich

ft:locale :

    - en-US

ft:publication_title :

    - Zurich Strategic Portfolio Management

ft:clusterId :

    - itbm

bundleId :

    - itbm

workflow :

    - Technology


---

# Customize your table map configuration

# Customize your table map configuration {#ariaid-title1}

* Release version: Zurich
* 
* Updated July 31, 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read

Map a Agile Development 2.0 table of your preference for a Jira project.

## Before you begin

* [Discover and import Jira projects and boards](https://www.servicenow.com/docs/yRf6vCJpfn2_03~lKZ3Scw "Discover and import all available Jira projects and boards into Agile Development 2.0 to start using the integration between the two applications.").
* Role required: sn_jira_int.user
{#custom-table-map-configuration__ul_ks2_r1c_ckb}

## About this task

Create a custom table map of your preference for your Jira project and configure its
fields.

If you have a custom table that is applicable to all Jira projects of a specific
project type, see [Apply custom map configuration to multiple Jira projects](https://www.servicenow.com/docs/9IOgECQ3NL3W8etqqfRKmg "Add a custom table or field, which is applicable to all your Jira projects of a specific type, to the map configuration template in Agile Development 2.0.").

## Procedure

1. Navigate to AllAgile Jira IntegrationJira Instances.
2. Open your Jira instance record.
3. From the Jira Projects related list, open a Jira project for which you want to customize the map configuration.
4. From the Table maps related list of the Jira project, click New.
5. On the form, fill in the fields.  
   {#custom-table-map-configuration__table_s3l_xlt_bkb__entry__2}

   | Field | Description |
   |-|-|
   | Internal Table | Table name in Agile Development 2.0. |
   | Map configuration | Map configuration for this project. This field is auto-populated based on the project. |
   | External Table | Table ID in Jira. |
   | External Table Name | Display name of the table in Jira. |
   [Table 1. Table Map form]

   {#custom-table-map-configuration__table_s3l_xlt_bkb}
6. Save the table configuration.
7. From the Field Maps related list of your table map record, create new field maps for the following fields:  
   {#custom-table-map-configuration__table_ufq_vrt_nkb__entry__2}

   | Field in Jira | Field in Agile Development 2.0 |
   |-|-|
   | Summary of the issue | Short description |
   | Description of the issue | Description |
   [ ]

   {#custom-table-map-configuration__table_ufq_vrt_nkb}

   For information on how to configure field mapping for a table, see [Customize your field map configuration](https://www.servicenow.com/docs/zLENf6PT7hBtfRCop41V4w#custom-field-map-configuration "Map a field of your preference for a Jira project."). You can also create other
   field maps for your new table configuration.
{#custom-table-map-configuration__steps_nrx_545_bkb}

## What to do next

1. Validate your new table map configuration by clicking Validate and fix mapping from your project form.
2. In the Table maps related list of your project, if the Valid column of your configuration shows:
   * true, validation of your map configuration is successful.
   * false, validation of your map configuration failed. Ensure that you enter correct values for all the fields and validate again.
   {#custom-table-map-configuration__ul_ezc_xzm_pkb}
3. Create a business rule to support export of this new table map configuration to Jira. See [Apply custom table map configuration for Agile Development 2.0 and Jira](https://www.servicenow.com/docs/fM7eVE17752dmz6KoRQJOg "Create a business rule to enable export from your new custom Agile Development 2.0 table map configuration to your Jira projects.").
4. If you want to support import and export of attachments for this new table map, see [Allow import and export of attachments on a custom Agile Development 2.0 table](https://www.servicenow.com/docs/yRmtEwd7qWEfank~pZRzHw "Enable import and export of attachments between Jira and Agile Development 2.0 for a custom Agile 2.0 table that you added to the map configuration.").
5. If you want to enable display of fields that reference Jira identifiers in your custom table map, see [Populate Jira identifier reference fields for Agile Development 2.0 custom table](https://www.servicenow.com/docs/Rquel0dfSP0qPdlCUjGpeg "Enable Jira identifier reference fields for your Agile Development 2.0 custom table that you added to the map configuration.").
{#custom-table-map-configuration__ol_dzc_xzm_pkb}

*[\>]: and then