Review Changes Made to Templates using the Storefront File Manager Version History

Review Changes Made to Templates using the Storefront File Manager Version History

This tutorial will show you how to use the Storefront File Manager version history to quickly identify that a file has been changed, who changed it, and see the differences between the two versions of the template file.  

In this example we are interested in looking at the changes made to the options.vm template.

NAVIGATE: Main Menu > Storefronts > Choose Storefront Host > (Storefronts Menu) File Manager

First we will navigate to the Storefront File Manager, where we can inspect the version history:

image-20250911-143824.png

Theme Directory Structure

We then need to navigate down the directory structure.

  • themes

    • <active theme folder>

      • templates

        • system

          • checkout

That brings us to the folder with the options.vm template.  You can see in the screen shot below that we've highlighted the file name and the current version number.

When you click on the version number it will display the file history.  The current version is always at the top.  You can compare the differences between the current version and a previous version by clicking the "diff" button.

image-20250911-144750.png

This will open up the difference view.  The left side contains the current version and the right side shows the previous versions.  Differences are highlighted in yellow so you can quickly see what has changed.  If you want to change which historical version you are looking at your can use the drop down located over the right document.  If you make edits to the current version on the left you can also click on Save.

 

 Frequently Asked Questions

Question: I’ve made some changes to my storefront and accidentally changes something that is suppressing a sidebar menu from appearing in the rendered page (I can see the sidebar in the Storefront Visual Builder editor.) How can I troubleshoot the issue or revert back to previous state?

Answer: If the element was no longer appearing in the editor, that would point to an edit that removed the sidebar elements from the page. In that situation, you could review the edited template version history and use the revert option to revert to a previous version of the template. However, in the situation where the element appears in the Visual Builder editor in the edit mode, you’ll want to investigate the settings panel for the if condition and or sidebar elements. Check for example the Visibility settings to ensure that the element is configured to be visible to the appropriate screen size (Mobile, Tablet, and/or Desktop device views.)