---
sourceDocument: Australia Strategic Portfolio Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/it-business-management

 Release :

    - australia

ft:locale :

    - pt-BR

ft:publication_title :

    - Australia Strategic Portfolio Management

ft:clusterId :

    - itbm

bundleId :

    - itbm

workflow :

    - Technology


---

# Customize your field map configuration

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

* Versão de lançamento: Australia
* 
* Atualizado 12 de mar. de 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 min. de leitura

Map a field of your preference for a Jira project.

## Antes de Iniciar

* [Discover and import Jira projects and boards](https://servicenow-prod.fluidtopics.net/A8ubcBeuy4EFh8SgmoLCNg "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-field-map-configuration__ul_ks2_r1c_ckb}

## Por Que e Quando Desempenhar Esta Tarefa

If you have a custom field for a Jira project that you want to map with a field in Agile Development 2.0, you can create custom field map configuration that would apply only to this Jira project.  
If you have a custom field that is applicable to all Jira projects of a specific project type, see [Apply custom map configuration to multiple Jira projects](https://servicenow-prod.fluidtopics.net/itwZEBJnzoS8QX~fu3qx6Q "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.").The following field types are supported for custom field map configuration:

* Number
* Select
* Text
* Date
* Identity
* Date time
* Reference
* List
{#custom-field-map-configuration__ul_um3_411_w4b}

## Procedimento

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, open the Sprint, Epic, or Story record to add a new field map configuration for that record.
5. From the Field Maps related list, click New.
6. On the form, fill in the fields.  
   {#custom-field-map-configuration__table_s3l_xlt_bkb__entry__2}

   | Field | Description |
   |-|-|
   | Internal Field | Field name in Agile Development 2.0. |
   | Table Map | Table map in Agile Development 2.0, in which this field is created. This field is auto-populated based on the table map record you select. |
   | Internal Table | Table in Agile Development 2.0. This field is auto-populated based on the table map record you select. |
   | External Field | Field ID in Jira. |
   | External Field Name | Display name of the field in Jira. Ensure that this field is added to the Jira project screen. |
   [Tabela 1. Field Map form]

   {#custom-field-map-configuration__table_s3l_xlt_bkb}
7. Click Update.

## O que Fazer Depois

1. Validate your field map configuration by clicking Validate and fix mapping from your project form.
2. From the Table maps related list of your project, navigate to your new field map configuration. 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 the correct values for all fields and validate again.  
     Importante:  
     If your custom map configuration is invalid or if the custom field configured is not added to the default screen scheme of the issue, the export action does not work.
   {#custom-field-map-configuration__ul_f2m_xmt_bkb}
{#custom-field-map-configuration__ol_qjd_tmt_bkb}

## Configuring a reference field in Jira {#ariaid-title2}

Understand how to configure a reference field while creating a new field map
configuration.
When you select a reference field for the Internal Field field, you must select a value for the Lookup Column Name field. The value from the Lookup Column Name
field is used during the import and export of work items between Jira DevOps and Agile Development 2.0.

During import, the integration application searches for the record in the reference table using the Lookup Column Name field. If the record is not found, the value in the work item will be empty in Agile Development 2.0.  

<br />