Publishing
Brief Overview
Publishing is the process of selecting, organizing, testing, and releasing the items you build in the WalkMe Editor. It makes your content available in different environments, such as test and production.
Publishing is a key step in your workflow:
- Test safely in a test environment before rollout
- Release confidently to your users in production
To view published items, your users must have WalkMe deployed and running in their browser. Otherwise, published content won't appear.
Use Cases
Publishing helps you manage how WalkMe appears across environments:
- Test items in a sandbox environment before releasing
- Archive items to remove them from an environment
- Organize and configure how items display in the WalkMe Menu
- Publish items to the production environment for users
How It Works
When you publish, WalkMe saves your items to a file on the server. This file has a unique ID (GUID) that matches your WalkMe Editor account.
For your users to see published items, WalkMe must be deployed and running in their browser. When WalkMe loads, it looks for the file with the matching ID and determines:
- Which items to display
- How items appear in the WalkMe Menu
- The order in which they appear
When you click Publish, only the items you select are released. Previously published items remain available โ you don't need to republish them.
Before publishing, you'll see a message showing how many new items are included. You can also choose to publish global settings.
Publishing Environments
You can publish WalkMe items to one or more environments, such as test or production. Each environment has its own snippet variation, and because they are unique, WalkMe must be deployed separately in each environment for items to be visible.
- The test snippet includes โtestโ in its link
- The production snippet uses the standard link
This setup lets you safely test changes in a sandbox environment before releasing them to your users in production.
You can deploy the snippet by adding it to your site's HTML or through a browser extension if you can't edit the source code.
Previewing WalkMe Items
Before publishing, you can preview your work directly in the WalkMe Editor. Preview mode lets you see how your implementation will appear on the siteโwithout publishing or installing the snippet.
While previewing, use the Flow Tracker to follow what happens step by step when a Smart Walk-Thru runs.
Best Practices Before Publishing
Before you publish, WalkMe recommends completing these steps to ensure your content looks consistent and performs as expected:
-
Ensure WalkMe is deployed
WalkMe must be running on your site for content to appear. ๐ Learn more about deployment methods -
Add goals
Goals provide the best way to measure success beyond usage graphs in Insights. ๐ Learn more about goals -
Set Unique User ID settings
Enable user tracking to see individual progress and usage across WalkMe Apps. ๐ Learn more about user tracking -
Review your design
Make sure your theme and branding are consistent across content. ๐ Learn more about Theming -
Publish to test and run QA
Test all items to confirm they work as expected. Review for broken links, text issues, and typos. ๐ Take the QA course at the Digital Adoption Institute
Publishing WalkMe Items
Follow these steps to publish:
- In the WalkMe Editor, select your items to publish
- Click Publish
- Choose the environment, usually test or production
- Select Publish Global Settings only if you want to include them
- Confirm the items and settings you've selected
- Click Publish to [environment]
Filtering content
You don't always need to publish everything at once. Filtering lets you release only what you need โ making publishing faster and more controlled.
For example, you might only want to publish:
- Items that are modified but not yet republished
- Items targeted to a specific audience, such as Sales
To filter content:
- In the WalkMe Editor, open the filter options (such as publishing status or segment)
- Select the items you want to publish, or click Select All
- Click Publish
Publish statuses
Each item in the editor shows a status icon that indicates whether it is available to your users.
Icon | Status | Description |
---|---|---|
|
Draft | The item has not been published to the server. |
|
Published | The item is published and has not been changed since. |
|
Modified | The item is published, but has been changed in the editor. Republish to update it. |
|
Archived | The item was previously published but has been removed from the server. |
Switching environment views
In the editor, you can switch between environments to see the content and publishing states for each.
To switch environments:
- Open the environment selector in the top bar of the editor
- Select the environment you want to view
- Review your content in that environment
Publishing settings
You can publish changes to settings without publishing other items.
To publish settings:
- In the WalkMe Editor, go to Settings
- Select System settings
- Click Publish settings
- Confirm the environment and settings
- Click Publish to [environment]
Manage Published Content
Archiving items
Archiving removes an item from the server so it is no longer available to your users. You must archive an item before deleting it.
To archive items:
- Select the items in the editor
- Click Archive at the bottom of the screen
- Review the summary and confirm
- Click Archive from [environment]
Unarchiving items
To restore an archived item:
- Open the Options menu next to the item
- Select Mark as draft
Deleting items
Deleting permanently removes items from the editor.
- If the item is published โ archive it first, then delete
Delete prompt for a published item โ requires archiving first. - If the item is already archived or was never published โ delete directly and confirm

Technical Notes
WalkMe Enabled toggle switch
If you need to quickly disable WalkMe in an environment, use the WalkMe Enabled toggle. When on, WalkMe runs normally. When off, the snippet is deactivated and content won't appear.
This is useful in urgent situations where you need to temporarily turn off WalkMe without removing the snippet from your site.
Impact of editor updates
WalkMe regularly updates the editor with new features and improvements. Updates don't affect items you've already published, but to use new features you'll need to edit your items and republish them.