{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Jira Ticketing Provider Custom Fields Configuration Guide","siteUrl":"https://docs.synqly.com","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Jira supports custom fields on tickets. This guide applies to both ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Atlassian Jira"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Jira Service Management"]}," integrations."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Custom fields can be scoped per integration (applied across all projects) or scoped to a specific Jira project."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"1-discover-available-field-names","__idx":0},"children":["1. Discover Available Field Names"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Field Path (Provider)"]}," in each mapping must be the field's ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["untranslated name"]}," as defined in Jira — for example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"Story Points\""]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"Due date\""]},"."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Log in to Jira as an Admin."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Administration"]}," (gear icon, top right) -> ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Issues"]}," -> ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Custom Fields"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The name shown in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Name"]}," column for each field is the untranslated name to use."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"2-configure-custom-field-mappings","__idx":1},"children":["2. Configure Custom Field Mappings"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When creating or editing your integration, enable the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Custom Field Mappings"]}," toggle. Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+ Add  Custom Field Mapping"]}," to add an entry for each field you want to map. Fill in the following for each entry:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Project ID"]}," ","Enter ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["*"]}," to apply the mapping to all projects, or a Jira project key (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["OPS"]},") to scope it to a specific project."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Field Path (Provider)"]}," ","The untranslated field name found in Step 1 (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Due date"]},")."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Name"]}," ","A unique key used to reference this field in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["custom_fields"]}," object when creating or patching tickets (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["due_date"]},")."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+ Add CustomFieldMapping"]}," to add additional mappings."]}]},"headings":[{"value":"1. Discover Available Field Names","id":"1-discover-available-field-names","depth":2},{"value":"2. Configure Custom Field Mappings","id":"2-configure-custom-field-mappings","depth":2}],"frontmatter":{"slug":"guides/provider-configuration/jira-custom-fields-setup","seo":{"title":"Jira Ticketing Provider Custom Fields Configuration Guide"}},"lastModified":"2026-04-30T13:43:16.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/provider-configuration/jira-custom-fields-setup","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}