---
schema_version: "1"
id: 5fe516736ec3998fdae132d5024f5358a8e4af6059c2ab05c42cdcdccbebf38c
title: Upgrade a Context Definition
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/ind/264-0-0/context_service_upgrade_context_definitions.md
canonical_url: https://help.salesforce.com/s/articleView?id=ind.context_service_upgrade_context_definitions.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 153c5ee77dcd00c80b8ec994c21d95e1adc622c37e32be322e96e0347ebe369f
description: Extended context definitions are auto-upgraded to their latest version. When an extended definition is out of sync with the standard definition, use the Sync Now option to instantly upgrade the standard components to their latest version. Easily track the progress of the sync by checking the sync status.
products:
  - Industry Solutions
  - Cross Cloud
release: "264"
---
# Upgrade a Context Definition

Extended context definitions are auto-upgraded to their latest version. When an extended definition is out of sync with the standard definition, use the Sync Now option to instantly upgrade the standard components to their latest version. Easily track the progress of the sync by checking the sync status.

### Required Editions

[Extend a Context Definition](https://help.salesforce.com/s/articleView?id=ind.context_service_extend_context_definitions.htm&release=264.0.0&type=5 "Extend a standard definition from which you want to inherit all the standard components such as nodes, attributes, and mappings. Customize the extended definition by adding new components. Use the Sync Now option to instantly upgrade the standard components to their latest version.")

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition"><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: Lightning Experience</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: <strong>Developer</strong>, <strong>Enterprise</strong>, <strong>Professional</strong>, and <strong>Unlimited</strong> editions for Industries clouds where Context Service is enabled</td></tr></tbody></table>

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small permission">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="colgroup" class="slds-cell-wrap" colspan="2" style="text-align:center;vertical-align:top;" id="d3895e80">User Permissions
              Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d3895e80 ">To upgrade context definitions:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d3895e80 ">Context Service Admin</td>

          </tr>
        </tbody>
      </table>

After you upgrade your orgs to the latest Salesforce version, your extended context definitions are automatically synced receive the latest updates. The new artifacts from the standard definition to the extended definition are automatically copied when:

- You go to Setup > Context Definitions, and click on an extended definition.
- An application hydrates the extended definition.
    
    ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ind-context_service-264-0-0-production-enus/e9dc37f3-cb53-4bc1-be8b-b6873099d0be/images/icon_note.png)
    
    Note The extended definition is not automatically synced when the hydration is triggered by an APEX code or Flow.

The auto-sync process can fail when:

- There is a conflict between artifact records in the custom definition. To solve this, click Sync to manually resolve the conflicts.
- The user does not have permissions to copy the records. To solve this, ensure that the user has the Context Service Admin permissions.
- The number of attributes or nodes in the context definition cross the Context Service limits. To solve this, delete unused custom nodes or attributes from your context definition. If it still doesn't work, contact Salesforce Customer Support.
- Invalid mapping records corrupt a context definition. To solve this, contact Salesforce Customer Support

![Important](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ind-context_service-264-0-0-production-enus/e9dc37f3-cb53-4bc1-be8b-b6873099d0be/images/icon_important.png)

Important

- Sync is not available for cloned context definitions.
- If the auto-sync fails, the Sync button is enabled only for the extended definitions that require an upgrade.
- To maintain data integrity, avoid performing a Sync in production orgs. First, perform the Sync in a sandbox org. Then, export the updated context definition as a package and deploy it to the production org.

1. From Setup, in the Quick Find box, enter Context Service, and then select **Context Definitions**.
2. On the Custom Definitions tab, from the action menu, select the extended definition that you want to upgrade, and then click **Sync Now**.
    
    If the extended definition fails to upgrade, you can do one of the following:
    
    <table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
              <tbody><tr class="">
                <td class="slds-cell-wrap">Preview</td>
                <td class="slds-cell-wrap">Lists the conflicting artifacts that prevent the extended definition from
                  upgrading.</td>
              </tr>
              <tr class="">
                <td class="slds-cell-wrap">Override</td>
                <td class="slds-cell-wrap">Removes the conflicting artifacts from the extended context definition and
                  replaces them with the corresponding artifacts from the standard context definition.<div>
                    <div class="slds-box slds-box_x-small slds-theme_shade slds-m-top_medium slds-m-bottom_medium">
                      <div class="slds-media slds-media_responsive">
                        <div class="slds-media__figure"><span class="slds-icon_container slds-icon_container_circle slds-icon-note-warning"><img style="margin-bottom:0;" src="https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ind-context_service-264-0-0-production-enus/e9dc37f3-cb53-4bc1-be8b-b6873099d0be/images/icon_important.png" alt="Important"></span></div>
                        <div class="slds-media__body" style="padding-top:.5rem;padding-bottom:.5rem;"><span class="slds-text-title_caps">Important</span> The conflicting artifacts are permanently removed.
                          Overriding the extended context definition is irreversible. To ensure that a
                          previous version of your custom data can be safely restored if required,
                          export the extended definition as a package before performing an
                          Override.</div>
                      </div>
                    </div>
                  </div>
                </td>
              </tr>
            </tbody></table>

#### See Also

- [Create a Context Definition](https://help.salesforce.com/s/articleView?id=ind.context_service_create_context_definitions.htm&release=264.0.0&type=5 "Create a context definition by choosing nodes, defining their relationship, adding attributes, and applying context tags.")
- [View, Edit, and Delete Saved Context Definitions](https://help.salesforce.com/s/articleView?id=ind.context_service_view_edit_saved_context_definitions.htm&release=264.0.0&type=5 "Extend or clone a standard definition, or clone a custom definition and modify it to meet your requirements. All your context definitions are listed on the Context Definitions page, under the Custom Definitions and Standard Definitions tabs. The Custom Definitions tab shows the definitions created by the customer, and the Standard Definitions tab shows the definitions available with the product.")
- [Extend a Context Definition](https://help.salesforce.com/s/articleView?id=ind.context_service_extend_context_definitions.htm&release=264.0.0&type=5 "Extend a standard definition from which you want to inherit all the standard components such as nodes, attributes, and mappings. Customize the extended definition by adding new components. Use the Sync Now option to instantly upgrade the standard components to their latest version.")
- [Context Service Developer Guide](https://developer.salesforce.com/docs/atlas.en-us.industries_reference.meta/industries_reference/context_service_overview.htm)
- [Context Service API (DELETE, GET)](https://developer.salesforce.com/docs/atlas.en-us.industries_reference.meta/industries_reference/connect_resources_context_service_runtime.htm?q=context+service)