What does the Launch Upgrade do?

The Launch Upgrade reads your DTM property and attempts to make a complete copy of that property in Launch. The resulting Launch property mimics the on-page behavior of your DTM property as closely as possible. To read about differences in structure, see Upgrade Preparation Guide.

When the upgrade is complete, a new property appears in Launch and a link to the new property is created. If the upgrade doesn't work, partially completed operations are deleted and an error message explains as much as possible about what went wrong. In some cases, error messages inform you that you can modify your DTM property and try the upgrade again.

The upgrade does not make any changes to your DTM property.

How should I prepare to upgrade?

Not everything you can do in DTM is compatible with Launch. A list of differences is available in the preparation guide. Make any necessary changes to your DTM property before you attempt the upgrade.

How do I start the upgrade?

Log in to DTM through the Experience Cloud, select your DTM property, then click Upgrade to Launch.

Why is my upgrade button grayed out?

If you mouse over the button, a message informs you why it is not available. There are a few typical reasons:

  • Your Property is Disabled - Enable the DTM Property first before you try to Upgrade.

  • You did not sign in through the Experience Cloud - Your DTM Company must be connected to the same Experience Cloud Org as your Launch Company. Log in through the Experience Cloud and try again.

  • You are not a DTM Admin - You must be have the DTM Admin right granted to you through Admin Console. Ask an Org Admin to grant you this right or find someone who already has it to perform the Upgrade for you.

What does the recommended upgrade process look like?

  1. Complete the upgrade process in DTM.

  2. Go to Launch and make a new Development library with all your new changes.

  3. Test thoroughly in your Launch Development environment.

  4. Adjust data elements and rules as desired.

  5. Promote changes through to the Launch Production environment.

  6. (Optional) Disable the DTM property any time after completing Step 1.

What do I do if the upgrade doesn't work?

The upgrade is expected to succeed in nearly every scenario. There are a few reasons why it might fail, such as:

  • You don't have the Manage Properties right in Launch. Ask your Org Admin (or a Launch Product Admin) to add you to a Product Profile with the Manage Properties right.

  • Your property has configuration issues. If the upgrade fails for this reason, DTM informs you that you have property configuration issues. Please check the Preparation Guide and try again.

In the rare case that your upgrade fails for any other reason, please contact Client Care and provide your DTM Company and Property Name. Client Care will work with the Launch team to help you out.