{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"ServiceNow 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":["ServiceNow supports custom fields on tickets. This guide applies to both ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["ServiceNow ITSM"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["ServiceNow Security Incident Response (SIR)"]}," integrations."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Custom fields in ServiceNow are per-ticket fields — they are not scoped to a project. Set ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Project ID"]}," to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["*"]}," for all mappings."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," Only fields whose column name begins with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["u_"]}," are supported. This is the standard ServiceNow convention for user-defined custom fields. Fields without the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["u_"]}," prefix will be rejected at integration initialization."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"1-find-custom-field-column-names","__idx":0},"children":["1. Find Custom Field Column Names"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Field Path (Provider)"]}," in each mapping must be the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["ServiceNow column name"]}," of the field, e.g. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["u_affected_system"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To find column names:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Log in to ServiceNow as an Admin."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["System Definition"]}," -> ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Dictionary"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Filter by ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Table"]}," (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["incident"]},") and look for entries where the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Column name"]}," starts with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["u_"]},". These are your custom fields."]}]},{"$$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 CustomFieldMapping"]}," 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"]}," ","Must be ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["*"]},". ServiceNow custom fields are not project-scoped."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Field Path (Provider)"]}," ","The ServiceNow column name found in Step 1 (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["u_affected_system"]},"). Must start with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["u_"]},"."]},{"$$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":["affected_system"]},")."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+ Add CustomFieldMapping"]}," to add additional mappings."]}]},"headings":[{"value":"1. Find Custom Field Column Names","id":"1-find-custom-field-column-names","depth":2},{"value":"2. Configure Custom Field Mappings","id":"2-configure-custom-field-mappings","depth":2}],"frontmatter":{"slug":"guides/provider-configuration/servicenow-custom-fields-setup","seo":{"title":"ServiceNow Ticketing Provider Custom Fields Configuration Guide"}},"lastModified":"2026-04-30T13:43:16.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/provider-configuration/servicenow-custom-fields-setup","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}