---
schema_version: "1"
id: 30fe5db02c6b07b54d5528af9e736510e62119bd3435d9868db516a0e70c72f7
title: Upsert Content with Trailmaker Release
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/sales/264-0-0/mth_upsert_content_with_tm_release.md
canonical_url: https://help.salesforce.com/s/articleView?id=sales.mth_upsert_content_with_tm_release.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 0f3b7b9b4bcd79e603537f3b85dda9b26cbae8a7d580ae02ac405e24d5a8dfb8
description: When you add or update content, use the upsert operation, which updates and inserts the content.
products:
  - Sales Cloud
  - Sales Enablement
release: "264"
---
# Upsert Content with Trailmaker Release

When you add or update content, use the upsert operation, which updates and inserts the content.

### Required Editions

<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: <strong>Enterprise</strong>, <strong>Performance</strong>, and <strong>Unlimited</strong> Editions</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="d11741e63">User Roles and
              Permissions</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Roles and Permissions" class="slds-cell-wrap" style="vertical-align:top;" headers="d11741e63 ">
              <strong>Enablement Site User Roles</strong>
            </td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d11741e63 ">&nbsp;</td>

          </tr>
          <tr class="">
            <td data-label="User Roles and Permissions" class="slds-cell-wrap" style="vertical-align:top;" headers="d11741e63 ">This topic supports these enablement site
              roles:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d11741e63 ">
              <ul>
                <li>Content Creators</li>

                <li>Release Managers</li>

              </ul>
            </td>

          </tr>
          <tr class="">
            <td data-label="User Roles and Permissions" class="slds-cell-wrap" style="vertical-align:top;" headers="d11741e63 ">
              <strong>Required System Permissions</strong>
            </td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d11741e63 ">&nbsp;</td>

          </tr>
          <tr class="">
            <td data-label="User Roles and Permissions" class="slds-cell-wrap" style="vertical-align:top;" headers="d11741e63 ">To create and edit content with Trailmaker Content:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d11741e63 ">Create Content</td>

          </tr>
          <tr class="">
            <td data-label="User Roles and Permissions" class="slds-cell-wrap" style="vertical-align:top;" headers="d11741e63 ">To upload content from Trailmaker Content to Trailmaker
              Release:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d11741e63 ">
              <p>Create Content </p>
              <p>AND</p>
              <p style="margin-bottom:0;">Manage Releases</p>
            </td>

          </tr>
          <tr class="">
            <td data-label="User Roles and Permissions" class="slds-cell-wrap" style="vertical-align:top;" headers="d11741e63 ">To create and manage releases with Trailmaker Release:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d11741e63 ">Manage Releases</td>

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

When you add content to an unpublished release from Trailmaker Release, you’re adding only each content’s manifest item, which specifies the content’s API name, type, and operation. For any content with the Upsert operation, go to Trailmaker Content and also add the corresponding content to the release. This step ensures that the backpack for new or updated content is uploaded to the release. To learn more, review [Considerations for Managing Releases](https://help.salesforce.com/s/articleView?id=sales.mth_how_releases_work.htm&release=264.0.0&type=5 "A release specifies the list of the modules and trails that you want to publish together at the same time. You can publish a module or trail only if it’s added to a release. Before you start lining up your planned releases, review some important guidelines about how releases work in Trailmaker.").

![Tip](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-sales-mytrailhead-264-0-0-production-enus/0d6bc03d-58c7-47e8-89c9-5e00c98b5485/images/icon_tip.png)

Tip In general, we recommend that you always use Trailmaker Content to upsert an individual item in a release. You save a few clicks, avoid potential confusion, and add the manifest item and backpack in the same action.

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-sales-mytrailhead-264-0-0-production-enus/0d6bc03d-58c7-47e8-89c9-5e00c98b5485/images/icon_note.png)

Note

- You can upsert a trail or a module but not a unit.
- To add a unit to an existing module, add the module to the release. Even if you’re fixing a small error in one unit, you add the entire module.
- You can publish modules individually or as part of a trail, but you can’t publish a trail without modules.

1. To add the items that you want to upsert, complete the steps in [Add Items to a Release from Trailmaker Release](https://help.salesforce.com/s/articleView?id=sales.mth_add_multiple_items_to_release_from_tm_release.htm&release=264.0.0&type=5 "You can add one or more items to a release from Trailmaker Release. Manually add items one at a time, or upload a CSV file that includes the full list of changes to process in the release. You can include up to 1,000 items in a release."). Be sure to specify the Upsert operation for each item.
2. Go to Trailmaker Content and add the corresponding content to the release. This step ensures that the backpack for new or updated content is uploaded to the release. Complete the steps in [Add Content to a Release from Trailmaker Content](https://help.salesforce.com/s/articleView?id=sales.mth_add_content_to_release_from_tm_content.htm&release=264.0.0&type=5 "After you create your module and quizzes and assign all the necessary metadata, add the content to a release.").

#### See Also

- [Considerations for Managing Releases](https://help.salesforce.com/s/articleView?id=sales.mth_how_releases_work.htm&release=264.0.0&type=5 "A release specifies the list of the modules and trails that you want to publish together at the same time. You can publish a module or trail only if it’s added to a release. Before you start lining up your planned releases, review some important guidelines about how releases work in Trailmaker.")
- [Add Content to a Release from Trailmaker Content](https://help.salesforce.com/s/articleView?id=sales.mth_add_content_to_release_from_tm_content.htm&release=264.0.0&type=5 "After you create your module and quizzes and assign all the necessary metadata, add the content to a release.")
- [Publish Content with Trailmaker Release](https://help.salesforce.com/s/articleView?id=sales.mth_publish_content_with_tm_release.htm&release=264.0.0&type=5 "After you test, proofread, and validate your content, you can publish the release's new or changed content to your enablement site.")