WMT Tool
The WEM Design Templates sync Tool
Getting started with WMT
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
WMTto yourusr/local/binfolder (or create one if it does not exist)Use
chmod +x WMTto 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.
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 TemplatesorE:\Wem\DesignTemplatesas used in examples below.
These settings can always be changed by running wmt config set:
WMT Login
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.
WMT Features
Config
Collection level commands
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.
Template level commands
Get List of Available Templates
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:
Create a new Design Template from a Source Template
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"
Download design template to local
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.
Compare local with server
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.
Pull to update local version
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
Push to send local changes to server
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.
Commit to start using changes
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.
Autopush
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
Delete Collection and Template
There is no option to delete a collection or a template.
If you have created a template and/or collection, but you are definitely not using it and want to have it deleted, please create a WEM Support ticket with the details of the Collection and the Template, so we can check all relevant references and do the proper removal.
Last updated
Was this helpful?