The WEM Design Templates sync Tool
The WEM Design Templates tool is a command line interface (CLI) to manage and synchronize WEM Design Templates.
With this tool you can connect to the WEM Design Template Server, get available design templates, create copies and upload changes.
To change the contents of Design Template (html, css, less) you can use the Visual Studio Code editor,that allows you to access the local copies of your Design Templates, and provides a powerful tool to work with the files and make changes.
Download and run the WDT Installer from the following location:
Type: installer
Type: zip containing WMT (without extension)
The publisher is not officially trusted by Windows, so you will have to explicitly override the warning to allow download and installation of this file.
Make sure to add the file WMT to your usr/local/bin folder (or create one if it does not exist)
Use chmod +x WMT to make sure the file is executable.
Configure the template folder path without relative paths. For example /Users/MyUser/Documents/Templates
Uninstall old Windows version manually
If you have a version from before 2024-12-13, you need to uninstall this version manually before installing the new version.
If you have used the defaults when installing WMT, you should find the old version and its uninstaller in:
C:\Program Files (x86)\Wem\Wmt
This is the 32-bit version. In this folder, you'll find the unins000.exe file, which will remove this version.
After installing the new WMT using the defaults, you will find it in:
C:\Program Files\Wem\Wmt
This is the 64-bit version.
Following information is based on Windows usage.
For MacOS-users, please use the appropriate corresponding commands and syntax.
After installation, the wmt command is available from the command prompt (or PowerShell):
The first time you run this command, it will ask for a few configuration settings:
Username - this should be the e-mail address that you use to login to the WEM Modeler.
Template path - the location where the design templates are stored locally. An example location could be C:\WEM Design Templates or E:\Wem\DesignTemplates as used in examples below.
These settings can always be changed by running wmt config set:
Before working with the WMT tool, you need to login with the following command:
This will start the WEM Login Portal (single sign on) on login.wem.io - where you can use your WEM account and MFA settings for secure login. If you already have a valid WEM Login session in your standard browser (for modeler or mywem), this session will be used to authenticate your WMT access.
The WEM Login in the browser can be set aside, or browser can be closed, while you continue in the WMT Tool in your Command Prompt / Powershell window (where it should show login successful). You can also explicitly logout of the WMT Tool, using the wmt logout command. This will remove your local access token for the WMT tool only. This will NOT end your WEM Browser Session, so you can continue your Modeler or MyWEM sessions in the browser without interruption.
Use -? with any command to show help and usage information
To get access to already existing custom Design Templates / Collections through the WMT Tool, WEM Support needs to explicitly link your account to the Design Template Collections.
This is NOT necessary if you want to work with existing Global Templates as a base for new custom templates > read "Create a new Design Template from a Source Template" further down this page.
Please create a Support Ticket in MyWEM, requesting access to specific Custom Design Template Collections, make sure you specifically indicate the Custom Design Templates you need access to.
A collection is used to group multiple Design Templates and can be linked to Workspaces, to make the Design Templates available in WEM Modeler Projects within those Workspaces. To make a certain Collection available to projects in your workspace, you need to use the share command to create a token, then use that token in WEM Modeler > Manage Workspaces > Add Design Template Collection.
The list, download and create commands can work from any current folder, because they use the root-folder from the configuration and fully-qualified Design Template Names ("Collection\Template") in case of download and create.
All other commands MUST be executed from within the local folder of a specific Design Template, so make sure you use the Change Directory (cd) command to set your CLI into the correct Template Folder.
The available Global Templates can be used as source for your own new custom Templates. To get a list of all available Global Templates, use wmt template list --global:
To create a new Design Template, you always use an existing Design Template as source. A copy of all files and folders will be made with the new Template's name.
The Names of the source and new Template should contain Collection and Template names:
-n "My Collection Name\My Template Name" -s "Source Collection Name\Source Template Name"
After creating the new Design Template (which happens on the server) you need to download it in order to start editing the template locally.
You need to have a local copy of the Design Template before you can push or pull changes.
All following commands MUST be executed from within the local folder of a specific Design Template, so make sure you use the Change Directory (cd) command to set your CLI into the correct Template Folder.
In the examples replace \Collection with the actual collection's name, and \Template with the actual template's name.
From within a local Design Template Folder, the WMT tool compares the local files to the server files and provides details on the files and lines which are different.
To pull the latest version of a specific Design Template or push changes from your local folder to the WMT Server, you first need to go to the correct folder in your CLI tool, until you see a path like the WMT root directory + collection name + template name; and then use wmt template pull
The push command updates the remote files with the local changes you made. This action will also perform a compile (LESS to css) and control step to inform you of any issues that may be in the contents.
The push command will NOT update the Design Template in the WEM Modeler at this stage!
For that final step - to update the Modeler to use the changed template - you need to execute the commit command.
From within a local Design Template Folder, the commit action performs the final step to make your changes available to the WEM Modeler for Preview, and for the publish process to Staging and Live.
Mind: only after Publish to Staging and Live, the changes in the Design Template will become available in those runtimes.
When you use the autopush command in a specific local Design Template folder, it will automatically trigger the push command when a local file has been changed and saved during the session while the WMT is active