--- sourceDocument: Australia IT Service Management sourceDocumentLink: https://www.servicenow.com/docs/r/australia/it-service-management Release : - australia ft:locale : - en-US ft:publication_title : - Australia IT Service Management ft:clusterId : - itsm bundleId : - itsm workflow : - Technology --- # Uploading your config data # Uploading your config data {#ariaid-title1} Release version: Australia Updated March 12, 2026 ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 minutes to read Summarize ![AI sparkle icon](https://servicenow.com/docs/portal-asset/ai-sparkle-icon) Summarized using AI This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete. ## Summary of Uploading your config data This guide explains how to upload existing configuration (config) data into the Common Data Model (CDM) application structure within ServiceNow. Starting with the Washington D.C. release, note that DevOps Config is being deprecated and hidden on new instances, but it remains supported. Show full answer Show less The process involves creating a new CDM application, defining its data structure, and then uploading your source config data into the CDM data tables using REST APIs or the config data editor. ## Uploading Config Data Process * **Create a new CDM application:** This represents the full collection of config data for an application service or model in the CMDB. For example, a Bookstore application. * **Generate a changeset:** Start defining the data structure ("modeling the data") by adding nodes such as components, collections, deployables, and configuration data items (CDIs). * **Structure example:** Components (e.g., PaymentSvc-1.0) can be included within collections (e.g., Release-1.0), which organizes the config data logically. * **Upload data:** Use the REST Explorer or APIs to upload source config data (e.g., JSON or XML) into the defined structure without committing the changeset immediately. * **API upload details:** POST requests upload config data, automatically generate upload scripts (supporting various scripting languages), and alphabetically sort uploaded items for easy navigation. ## Important Limits and Settings * Maximum of 100,000 CDIs per application. * Maximum of 10,000 CDIs per deployable. * These limits can be configured via the `sncdm.maxallowedcdiperapplication` and `sncdm.maxallowedcdiperdeployable` system properties. ## Post-Upload Management * Review and update the config data within the CDM application. * Commit the changeset to generate snapshots of deployables and store data in CDM tables. * Manage config data through updates, policy validations, and exporting valid snapshots. * Export operations can generate API code to automate the export process. ## Additional Notes * When uploading XML with `ignoreAttributes` set to false, XML attributes are preserved in JSON format. * The upload API facilitates automation by generating scripts usable in CI/CD pipelines. You first create a new CDM application structure and then upload the existing config data into the structure. Important: Starting with the Washington D.C. release, DevOps Config is being prepared for future deprecation. It will be hidden and no longer activated on new instances but will continue to be supported. ## How it works: Performing the initial upload of your existing config data into CDM data tables {#cdm-upload-process__section_ps3_f23_yqb} 1. Open the CDM user interface and create a new application. For example, let's create the Bookstore application to support an online bookstore. An application in CDM is the full collection of config data for an application service, application model, or dynamic CI group \[infrastructure\] in the CMDB. 2. Now open the Bookstore application and generate a new changeset so you can begin to put the data structure in place. (A more detailed overview of this process appears in [Preparing an application for config data upload](https://www.servicenow.com/docs/8Q5kClfh4tg6NVjQaKuLmw "An application in CDM is the full collection of config data for an application service, application model, or dynamic CI group [infrastructure] in the CMDB. After you upload your source config data, the application can support all potential deployables that make up each version of the development, test, and production environments of the service.").) In the changeset, define the data structure that includes a node for each set of config data that you will upload. This process is called modeling the data. You add components, collections, deployables, and CDIs as needed. For information on each of these items, see [CDM data model](https://www.servicenow.com/docs/ZN7eqYO5WCjS4cDDgfQaQQ "The CDM data model is a standardized data structure that supports the broader life cycle of software delivery — automation, quality validation, and CSDM. CDM imports existing config data, validates it using policies that you define, and exports valid config data to your organization's existing DevOps pipeline to implement applications, services, and infrastructure."). For additional information on adding nodes to an application, see [Preparing an application for config data upload](https://www.servicenow.com/docs/8Q5kClfh4tg6NVjQaKuLmw "An application in CDM is the full collection of config data for an application service, application model, or dynamic CI group [infrastructure] in the CMDB. After you upload your source config data, the application can support all potential deployables that make up each version of the development, test, and production environments of the service."). In this example, two components and two collections have been added. Now, the PaymentSvc-1.0 component is included in the Release-1.0 collection. As with all collections, this means that any data in the PaymentSvc-1.0 component is now included in the Release-1.0 collection. When you are satisfied with the structure (you can update at any time), you open the REST Explorer to begin the process of uploading the source config data into the CDM data tables. Do not commit the changeset --- it remains open so you can upload data. 3. Using the REST APIs or the config data editor, set parameter values that specify the name of the application to upload to, the path within the CDM application data structure to place the data, the format of the source data (JSON in the example), and so on. Note: When you upload your existing config from an XML file and the ignoreAttributes is set to false, the CDM XML Parser retains the attributes in JSON using identifiers. For more information, see [Parsing of XML files in CDM](https://www.servicenow.com/docs/vlUWWn4qLazV6WiL9Afq8A "The CDM XML parser enables the parsing of attribute key-value pairs in XML files, so when you upload config data from an XML file into CDM, you can easily identify the attributes of each element in the CDM editor or list view."). This example shows the REST API Explorer platform utility for clarity. This is an example of how you might construct an Upload to components REST POST request that creates a dbProperties.json node in the PaymentSvc-1.0 component and then adds the source data to the new node. (You specify the source data to upload in another field.) The APIs are described in [CdmApplicationsApi](https://www.servicenow.com/docs/access?context=applications-api&version=australia&pubname=australia-api-reference&ft:locale=en-US), [CdmChangesetsApi](https://www.servicenow.com/docs/access?context=changesets-api&version=australia&pubname=australia-api-reference&ft:locale=en-US), and [CdmSnapshotApi](https://www.servicenow.com/docs/access?context=snapshot-api&version=australia&pubname=australia-api-reference&ft:locale=en-US). 4. When you select Send, the API reads the original config data, uploads it and aligns it into the CDM data structure. Note: Uploaded data items are sorted alphabetically within the structural folders to enable you to locate particular items quickly. The system places the following limits on the count of config data items (CDIs): * An application can contain a maximum total of 100,000 CDIs. * Any single deployable can contain a maximum of 10,000 CDIs. {#cdm-upload-process__ul_r5n_5vg_yqb}See [CDM system properties](https://www.servicenow.com/docs/R83qYUPVmLKEL3X0mlK0mQ "CDM system properties.") for information on configuring the sn_cdm.max_allowed_cdi_per_application and sn_cdm.max_allowed_cdi_per_deployable property settings. Important: Each time you submit a POST request, the API performs the POST and also generates an upload script. You can specify one of several script languages. The purpose is for you to use the code in your pipeline system to automate the upload process for this application in future uploads. 5. Back to CDM: Review and update the config data as described in [Preparing an application for config data upload](https://www.servicenow.com/docs/8Q5kClfh4tg6NVjQaKuLmw "An application in CDM is the full collection of config data for an application service, application model, or dynamic CI group [infrastructure] in the CMDB. After you upload your source config data, the application can support all potential deployables that make up each version of the development, test, and production environments of the service."). 6. When you are satisfied that the application is a full and correct representation of the config data, you can commit the changeset. The commit action generates a snapshot of each deployable and causes the API to store the data in CDM tables. Now that the application is fully in place, you can manage the data as needed: Update config settings, apply policies to validate the data, export valid snapshots of config data, and so on. While you export any snapshot, the system can generate API code that you can use to automate the export process. See [Generate API invocation code for an exporter](https://www.servicenow.com/docs/uhDkUHzjBiklNo8kqVPUgw "Generate sample code of an API invocation for an exporter. The code can invoke the exporter. Select from several commonly used languages.") for details. {#cdm-upload-process__ol_qw4_s53_yqb} **Related concepts** * [Preparing an application for config data upload](https://www.servicenow.com/docs/8Q5kClfh4tg6NVjQaKuLmw "An application in CDM is the full collection of config data for an application service, application model, or dynamic CI group [infrastructure] in the CMDB. After you upload your source config data, the application can support all potential deployables that make up each version of the development, test, and production environments of the service.") * [Parsing of XML files in CDM](https://www.servicenow.com/docs/vlUWWn4qLazV6WiL9Afq8A "The CDM XML parser enables the parsing of attribute key-value pairs in XML files, so when you upload config data from an XML file into CDM, you can easily identify the attributes of each element in the CDM editor or list view.") * [Parsing of CSV files in CDM](https://www.servicenow.com/docs/uoHe0~WoJwfrtiVzG2Sp1g "The CDM CSV parser enables parsing of data in CSV files, so when you upload config data from a Comma-Separated Values (CSV) file into CDM, you can easily identify the data format attributes and config data in the CDM editor or list view.")