How To Update Data Layer Versions

For versions 2.0 and higher, this guide will show you how to update your Data Layer version as new versions are release so you can take advantage our latest improvements!

πŸ‘

Upgrade to our latest Shopify source and you'll be on auto updates!

Learn more about our new simplified Shopify source, that will set you up for auto updates and never need to update the data layer again!

Follow our guide on How to Implement the Shopify Source.

Why should I update my Data Layer?

Before showing you how to upgrade, you might wonder "why should I update"?

πŸ“˜

Many of our versions are not mandatory. You can view our changelog at any time to see the bug fixes and/or enhancements we've made.

In general, the latest version is going to be our best version available for our Shopify customers. This includes bug fixes (large and small) and additional enhancements that we are making to improve overall tracking and attribution accuracy.


If there is a breaking update change then we typically call this out as a notice in your Data Layer settings page.


Inside your Elevar account go to "My Tracking" in the main navigation.

Then in the Overview setup step, you will see the notification - "Update Available". This means that we've released a newer dataLayer.

screenshot of my tracking within Elevar app showing update available

Just click on the "View" link to see the Overview.

In the example below, the store is currently using v.3.3.0 dataLayer version installed, but version 3.4.3 is now available to upgrade.

🚧

Updating the Elevar Data Layer updates the Elevar code directly on the current live theme on the Shopify store.

If you are using version control platform like GitHub, then please make sure that all the changes made in the live theme post the update, are merged into your version control platform.

screenshoot in Elevar app of the update available

πŸ“˜

Note: This is a manual process, so you'll need to complete all the steps.

Updating the Data Layer to the latest version

Click the "Start Update" button to proceed with the installation wizard. You will then enter "Update Mode"

**Optional: How to Track Attribution Data on Non-Shopify Subdomains**]

Option 1: For Non-Plus Shopify Stores or Plus Store using checkout extensibility (only):

You will be redirected automatically to the "Configure Checkout" step

Replace the "Order Status Page Script" with the latest one. Once done, Click the "Mark as Complete & Continue" button to proceed to the Final Step.

πŸ“˜

Note: If you are really on Non-Plus Shopify Store, and you are not seeing the Thank you page script outline on this step, then it's most likely you have a checkout.liquid in the theme. You'll just need to remove/delete it since this doesn't do anything on your store (you can confirm with Shopify support about this).

Click on the "Reinstall" Button. And that's it!

Option 2: For Shopify Plus Stores (only):

You will be redirected automatically to the final step "Install on Store"

Click on the "Reinstall" Button. And that's it!

Once you are done with the upgrade and have reinstalled the snippets then you will see this "You're up to date" callout:

🚧

If you are using GitHub or any other version control platform for your theme management, make sure to merge the Elevar code changes with them.

Updating the Elevar Data Layer updates the Elevar code directly on the current live theme on the Shopify store.

If you are using version control platform like GitHub, then please make sure to merge the following updated files into your version control platform from your live theme to make sure that all the changes reflect in all future versions of yoru theme files:

  1. theme.liquid
  2. checkout.liquid
  3. elevar-head.liquid
  4. elevar-body-end.liquid
  5. elevar-head-listener.liquid
  6. elevar-checkout-end.liquid

Cancel Update

If you want to cancel the upgrade mid-process then you'll just need to click the "Update Mode" button at the top right corner to see the "Cancel Update" button.

Post Purchase Upsell Tracking Required Updates

If you have your Data Layer install configured for tracking post purchase upsells, you'll need to follow the initial setup guides to refresh your Data Layer adjustments like your initial post purchase tracking install.

Have any questions? Let us know.