LogoLogo
WEM ModelerWEM ReferenceTutorialsMyWEM
  • WEM Platform Documentation
  • Getting Started
    • Introducing WEM
    • Create WEM Account
    • WEM Login
    • MyWEM Portal
      • MyWEM Features
      • MyWEM Support
      • Allow Support Access
    • Partner Portal
  • WEM Modeler
    • Introducing the WEM Modeler
    • Modeler Start Page
    • Manage Projects & Workspaces
    • User Roles Scheme
    • Create a new Project
    • Modeler Application Overview
    • Project Settings
      • Project Configuration
      • Security Settings
      • Portal Settings
      • SMTP Settings
      • Mobile App Settings
    • Expression Editor
    • Flowcharts
      • User Interaction
      • End Node
      • Sub-flowchart
      • Navigation
      • Clear session
      • Decision
      • Assignment
      • List Action
      • Loop
      • Copy Data
      • Save and Discard
      • Import Data
      • Export Data
      • Invoke Webservice
      • HTTP Request
      • Execute Process
        • Different processes explained
        • Send Email
        • Change settings
        • Changing files
        • Generate File
      • Ping server
      • Authenticate
      • Comet Messages
      • OpenAI
      • Async Tasks
      • Note Node
    • Data Model
      • WEM Session Folder
    • Services and Integration
      • Webservices
      • Remote Data Sources
      • Authentication Providers
        • SAML 2.0
          • SAML App Registration in EntraID
        • OAuth 2.0
      • Comet - Real Time Messages
      • Certificates
    • Concepts and Concept Queries
      • Concepts
      • Concept Queries
      • Concept Relations
    • Navigation
      • HTTP Endpoints
      • Tasks
    • Files and Assets
      • Widget Libraries
      • Template Fragments
      • Files
      • Hyperlinks
    • Multilanguage Dictionary
    • Agentic AI
      • WEM AI Agent
      • AI Flowchart Nodes
      • AI User Interaction
    • WEM Preview
    • WEM Runtime
      • Publishing Process
      • Staging
      • Live
    • Debugging
  • Template Editor
    • Interaction Template Editor
      • Interaction Template Hotkeys
    • General and preview
    • Style
      • Heading Type
      • Paragraph Style
      • Text Styling
      • Alignment
      • Hyperlink
      • Tooltip
    • Layout
      • Adaptive columns
      • Div
      • Panel
      • Alert
      • Table
      • Image
      • Icon
      • Label
    • Interaction
      • Form
      • Validation
      • Required field
      • Button
      • Dropdown
      • Free form item
    • Miscellaneous
      • Tabbar
      • Google maps
      • Nested template
      • Script
      • Reference
      • Conditional
      • Data grid
      • Repeater
      • Rich text
      • Custom
    • WMT Tool
  • WEM Reference
    • WEM Expressions Reference
    • Functions
      • Aggregation
        • Average
        • Count
        • First
        • Last
        • Max
        • Min
        • Sum
      • Concepts
        • ConceptId
        • Description
        • FindConcepts
        • GetAncestors
        • GetChildren
        • GetDescendants
        • GetParent
        • Intersection
        • LocalName
        • Synonyms
        • ToConcept
        • Union
      • Date
        • Date
        • DateDiff
        • DateOnly
        • DatePart
        • DayOfWeek
        • FromUnixTimestamp
        • MoveDate
        • Now
        • TimeOfDay
        • Today
        • ToDuration
        • ToLocal
        • ToUnixTimestamp
        • ToUTC
        • UTCNow
        • UTCToday
      • Environment
        • ApplicationId
        • CountryCode
        • CountryName
        • Hostname
        • IpAddress
        • IsFirstRequest
        • IsHttps
        • IsPreview
        • IsStaging
        • IsLive
        • NodeTrail
        • PortalId
        • PortalName
        • ProjectId
        • ProjectName
        • ProjectVersion
        • Setting
        • UrlPath
      • Files
        • FileName
        • FileSize
        • FileUrl
        • MimeType
      • Lists
        • Distinct
        • IsNewRow
        • IsOnRow
        • List
        • NameOf
        • RowId
      • Math
        • Abs
        • Ceiling
        • Cos
        • Distance
        • Exp
        • Floor
        • Log
        • Log10
        • Pi
        • Pow
        • Random
        • Round
        • Sin
        • Sqrt
        • ToNumber
      • Security
        • AesDecrypt
        • AesEncrypt
        • AesIv
        • AesKey
        • CreateJsonWebTokenH256
        • HmacSha256
        • Md5
        • Password
        • PasswordStrength
        • Pbkdf2
        • Sha1
        • Sha256
        • Totp
      • Text
        • AsText
        • Base32ToText
        • Base64ToText
        • CompareFuzzy
        • Concat
        • Contains
        • FormatDate
        • FormatDuration
        • FormatNumber
        • Guid
        • HexToText
        • HtmlAttributeEncode
        • HtmlEncode
        • IndexOf
        • JavascriptEncode
        • JsonEncode
        • Length
        • Padl
        • Padr
        • RegExIsMatch
        • RegExMatches
        • RegExReplace
        • Replace
        • Split
        • StringPart
        • SubString
        • ToBase32
        • ToBase64
        • ToBase64Url
        • ToHex
        • ToLower
        • ToRichText
        • ToString
        • ToTitleCase
        • ToUpper
        • Trim
        • UrlDecode
        • UrlEncode
        • XmlAttributeEncode
        • XmlEncode
        • XPath
        • XPathList
        • XPathNumber
      • Validation
        • HasValue
        • IsEmpty
        • IsKnown
        • IsUnknown
        • IsValidBankaccount
        • IsValidBSN
        • IsValidBTW
        • IsValidEmailAddress
        • IsValidIBAN
        • IsValidPhonenumber
        • IsValidURL
      • Localization
        • AvailableLanguages
        • CurrentLanguage
        • CurrentTimezone
        • LanguageStrategy
        • Languages in WEM
    • Keywords
      • Contains
      • Concepts
        • Ancestor of
        • Child of
        • Concept
        • Descendant of
        • Overlaps
        • Range of
        • Parent of
        • Contains
      • Environment
        • ApplicationRoot
        • Platform
      • Lists
        • In
        • Of
        • Where
        • Contains
        • All
      • Logic
        • And
        • Not
        • Or
        • Choose
        • If Then Else
      • Mobile
        • BatteryLife
        • BuildVersion
        • ConnectivityTypes
        • DeviceId
        • DeviceName
        • IsDevelopmentBuild
        • IsDistributionBuild
      • Text
        • Contains
        • Ends with
        • NewLine
        • Starts with
    • Operators
      • Addition +
      • Division /
      • Equality =
      • Equality-strong ==
      • Greater-than >
      • Greater-than-or-equal >=
      • If-unknown ?
      • Inversion -
      • Less-than <
      • Less-than-or-equal <=
      • Logical-and &, and
      • Logical-not !, not
      • Logical-or |, or
      • Modulo %
      • Multiplication *
      • Power ^
      • Subtraction -
      • Unequality <>
    • Data Types
      • Text
      • Number
      • Yes / No (Boolean)
      • Date Time
      • Duration
      • File
      • Rich Text
      • Concept
      • Conceptset
      • Reference
    • SQL Compatibility
      • Functions
      • Keywords
      • Operators
    • Content Security Policy
    • WEMScript for Custom HTML
    • WEM Widgets
      • WEM Widget Structure
      • WEMScript for Widgets
      • Widget Editor
      • Content Placeholder
    • WMT
      • File Structure
      • Basic Functional Template
      • Styling
      • Font Icons
      • Reference
        • Breadcrumb
        • Button Bar Buttons
        • Common Scripts
        • Common Styles
        • Conditional
        • Content
        • CSP
        • CSP Nonce
        • Expression
        • Hidden Fields
        • Language Select
        • Navigation
        • Node ID
        • Node Name
        • Placeholder
        • Placeholder Conditional
        • Startup Scripts
        • Template Fragment
        • Uses
    • Regression Test Framework
      • WEM Test Script
  • Tutorials
    • Tutorials
      • Making a Change Log
      • Placeholders for end-users
    • First Application
      • Expand First Application
    • Video Tutorials
      • By Partners
      • Security
    • Building Widgets
      • Basics
        • 1. Introduction
        • 2. Hello, World!
        • 3. General
        • 4. Properties
        • 5. Events
        • 6. Styling
        • 7. View State
        • 8. Resources
        • 9. Placeholders
        • 10. Template Editor Script
        • 11. Global Scope
        • 12. Risks and Responsibilities
        • 13. Conclusion
      • In-depth
        • 1. Introduction
        • 2. Platform Availability
        • 3. Development Workflow
        • 4. Properties
        • 5. View state
          • 1. Runtime.viewState
          • 2. sessionStorage
          • 3. Summary
        • 6. Styling
        • 7. Events
          • 1. Navigation
          • 2. Row position
      • WEMscript
        • 1. Introduction
        • 2. Variables
        • 3. Properties
        • 4. OutputId()
        • 5. Register Input - Required
        • 6. Encoding
        • 7. Script Block - Introduction
        • 8. Types
          • 1. Boolean
          • 2. Concept
          • 3. ConceptSet
          • 4. Datetime
          • 5. Duration
          • 6. File
          • 7. Number
          • 8. Richtext
          • 9. Text
        • 9. Script Block - Global Scope
        • 10. Script Block - ES Modules
        • 11. CSS - attachShadow
      • Examples
  • Tips and Tricks
    • Tips and Tricks
      • Keyboard Shortcuts
      • Video's in WEM
      • Extracting text from File
    • Custom Hostnames
    • FAQ
    • Expressions
      • Order of Operators
    • Processes
      • Email Process
      • Tips for creating PDF's
      • ZIP Archive Process Node
    • Concepts
      • Concepts and Runtime
    • Working with data
      • The Power of the Calculated Field
      • Consuming your OData source with Excel 2016
      • Expose your data via OData
      • Using OData to transfer data between runtimes
      • WEM Storage Options
    • Integration
      • Integrating external systems
      • Json
      • Single Sign-on
      • Office365 Integration
    • Performance
      • Performance Tips
      • Performance Profiler
      • Template Performance Profiler
      • The Split Loop
    • Security
      • 2FA with TOTP
      • Blacklist or whitelist IP addresses
    • Widgets
      • Advanced Charts
        • Boxplot Chart
        • Brush Chart
        • Bubble Chart
        • Candlestick Chart
        • Card with Chart
        • Effect Scatter Chart
        • Heat Map
        • Line, Area and Bar Chart
        • Map-Bar Morph
        • Mix Time Line Chart
        • Nested Pie Chart
        • Polar Area Chart
        • Polar Bar Chart
        • Profit Chart
        • Radial Bar Chart
        • Radial Bar Gauge
        • Range Bar Chart
        • Rosetype Pie Chart
        • Sankey Energy Chart
        • Scatter Chart
        • Scatter-Aggregate-Bar Chart
        • Stacked Columns Chart
        • Stepline Chart
        • Treemap
      • Advanced Input
        • Color Picker
        • Conceptset Image Selector
        • Google maps locator
        • Multi select input button
        • MultiFile Upload
        • On/Off switch
        • Process Arrow Steps
        • Rate
        • Rating view
        • Single select input button
        • Slider
        • Tree
      • Template Actions
        • Follow exit
      • Global widgets
        • Agenda
        • Audio Player
        • Calendar
        • Draw Signature
        • Grid Widget
        • Image capture
        • Kanban Board
        • Path
        • Progress Bar
        • reCAPTCHA
        • Timeline
      • Document widgets
        • Json Viewer
        • PDF Viewer
    • Various
    • Go to MyWEM
Powered by GitBook
On this page
  • Getting started with WMT
  • WMT Login
  • WMT Features
  • Config
  • Collection level commands
  • Template level commands
  • Get List of Available Templates
  • Create a new Design Template from a Source Template
  • Download design template to local
  • Compare local with server
  • Pull to update local version
  • Push to send local changes to server
  • Commit to start using changes
  • Autopush

Was this helpful?

Export as PDF
  1. Template Editor

WMT Tool

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.

Getting started with WMT

Download and run the WDT Installer from the following location:

WINDOWS
MacOS

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):

C:\> wmt

The first time you run this command, it will ask for a few configuration settings:

  1. Username - this should be the e-mail address that you use to login to the WEM Modeler.

  2. 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.

C:\> wmt
No configuration found.
​
Username: *************
Template path: E:\Wem\DesignTemplates
​
The configuration has been saved.

These settings can always be changed by running wmt config set:

C:\> wmt config set -?

Description:
  Alters the current configuration

Usage:
  Wmt config set [options]

Options:
  -s, --server <server>  The hostname of the remote wmt server
  -u, --user <user>      The user which will be used to connect to the remote wmt server
  -p, --path <path>      The root directory in which all the master templates are stored
  -?, -h, --help         Show help and usage information

WMT Login

Before working with the WMT tool, you need to login with the following command:

C:\> wmt login

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

Use -? with any command to show help and usage information

C:\> wmt -?
Description:
  WMT is a tool to manage WEM design templates

Usage:
  Wmt [command] [options]

Options:
  --version       Show version information
  -?, -h, --help  Show help and usage information

Commands:
  config
  login       Logs in to the remote wmt server
  logout      Logs out from the remote wmt server
  collection
  template
  version     Shows the version of this WMT command line interface

Config

C:\> wmt config -?
Description:

Usage:
  Wmt config [command] [options]

Options:
  -?, -h, --help  Show help and usage information

Commands:
  show  Shows the current configuration
  set   Alters the current configuration

C:\> wmt config show
Server:     https://wmt.wem.io
User:       ******************
Path:       E:\Wem\DesignTemplates
Logged in:  yes

Collection level commands

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.

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.

C:\> wmt collection -?
Description:

Usage:
  Wmt collection [command] [options]

Options:
  -?, -h, --help  Show help and usage information

Commands:
  list           Shows a list of existing template collections
  create <name>  Creates a new template collection
  share <name>   Creates a token to link the collection to workspace

Template level commands

C:\> wmt template -?
Description:
​
Usage:
  Wmt template [command] [options]
​
Options:
  -?, -h, --help  Show help and usage information
​
Commands:
  list             Shows a list of existing templates
  download <name>  Downloads an existing template from the server
  create           Create a new template
  pull             Pulls the latest version from the server
  push             Pushes the local changes to the server
  commit           Commit the changes on the server
  compare          Compares the local files with the version on the remote server
  autopush         Watches for file changes and automatically pushed the changes to the server

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.

Get List of Available Templates

PS E:\WEM\Design Templates\> wmt template list /?
Description:
  Shows a list of existing templates

Usage:
  Wmt template list [options]

Options:
  -c, --collection <collection>  When provided, only shows the template of this collection
  -g, --global                   This flag shows the global design templates
  -?, -h, --help                 Show help and usage information

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:

PS E:\Wem\DesignTemplates> wmt template list --global
NAME                              CREATED             MODIFIED
Global\Corcovado                  31-5-2022 06:53:08  31-5-2022 06:53:08
Global\Customizable - Main        31-5-2022 06:53:08  31-5-2022 06:53:08
Global\Dashboard - Basic blue     31-5-2022 06:53:09  31-5-2022 06:53:09
Global\Dashboard - Basic grey     31-5-2022 06:53:09  31-5-2022 06:53:09
Global\Dashboard - Basic purple   31-5-2022 06:53:09  31-5-2022 06:53:09
Global\Dashboard - Basic red      31-5-2022 06:53:09  31-5-2022 06:53:09
Global\Dashboard - Dark and blue  31-5-2022 06:53:09  31-5-2022 06:53:09
Global\Dashboard - Light          31-5-2022 06:53:09  31-5-2022 06:53:09
Global\Default                    31-5-2022 06:53:09  31-5-2022 06:53:09
Global\Foodz.nl                   31-5-2022 06:53:09  31-5-2022 06:53:09
Global\Grand Canyon               31-5-2022 06:53:09  31-5-2022 06:53:09
Global\Mobile - Android           31-5-2022 06:53:10  31-5-2022 06:53:10
Global\Mobile - iOS               31-5-2022 06:53:10  31-5-2022 06:53:10
Global\Mont Blanc                 31-5-2022 06:53:10  31-5-2022 06:53:10
Global\Mont Forel                 31-5-2022 06:53:10  31-5-2022 06:53:10
Global\Dashboard - Tokelau light  7-7-2022 16:21:10   7-7-2022 16:21:10
Global\Basic - Amethyst           7-8-2023 13:29:45   7-8-2023 13:29:45
Global\Basic - Graphite           7-8-2023 13:30:04   7-8-2023 13:30:04
Global\Customizable - Snowflake   2-12-2024 15:26:29  2-12-2024 15:26:29

Create a new Design Template from a Source Template

PS C:\> wmt template create -?
Description:
  Create a new template

Usage:
  Wmt template create [options]

Options:
  -n, --name <name> (REQUIRED)      The name of the new template
  -s, --source <source> (REQUIRED)  The name of the source template
  -?, -h, --help                    Show help and usage information

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.

PS E:\Wem\DesignTemplates> wmt template download "Collection Name\Template Name" 
...

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.

PS E:\Wem\DesignTemplates\Collection\Template> wmt template compare
...
Only on server: ...
Different version: ...
...

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

PS E:\Wem\DesignTemplates\Collection\Template> wmt template pull
...
Added file ...
Updated ...
...

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.

PS E:\Wem\DesignTemplates\Collection\Template> wmt template push
...

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.

PS E:\Wem\DesignTemplates\Collection\Template> wmt template commit
...
...

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

PS E:\Wem\DesignTemplates\Collection\Template> wmt template autopush
...
Watching for file changes. Press "q" to stop watching...

PreviousCustomNextWEM Expressions Reference

Last updated 3 months ago

Was this helpful?

This will start the (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.

This is NOT necessary if you want to work with existing Global Templates as a base for new custom templates > read "" further down this page.

Please create a Support Ticket in , requesting access to specific Custom Design Template Collections, make sure you specifically indicate the Custom Design Templates you need access to.

WEM Login Portal
MyWEM
Create a new Design Template from a Source Template
WMT Setup Windows (exe)
WMT App for MacOS