Welcome to the WalkMe Help Center

Please login in order to continue:

Work flows better with WalkMe
Work flows better with WalkMe.

Publishing

Last Updated August 28, 2025

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.

๐ŸŽ“ Digital Adoption Institute

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.

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

WalkMe Deployment Overview

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.

Flow Tracker

Best Practices Before Publishing

Before you publish, WalkMe recommends completing these steps to ensure your content looks consistent and performs as expected:

  1. Ensure WalkMe is deployed
    WalkMe must be running on your site for content to appear. ๐Ÿ‘‰ Learn more about deployment methods

  2. Add goals
    Goals provide the best way to measure success beyond usage graphs in Insights. ๐Ÿ‘‰ Learn more about goals

  3. Set Unique User ID settings
    Enable user tracking to see individual progress and usage across WalkMe Apps. ๐Ÿ‘‰ Learn more about user tracking

  4. Review your design
    Make sure your theme and branding are consistent across content. ๐Ÿ‘‰ Learn more about Theming

  5. 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:

  1. In the WalkMe Editor, select your items to publish
  2. Click Publish
  3. Choose the environment, usually test or production
  4. Select Publish Global Settings only if you want to include them
  5. Confirm the items and settings you've selected
  6. Click Publish to [environment]
Note

  • A progress bar will confirm each stage of publishing. If publishing fails, you'll see an error message showing where it stopped.
  • Accounts with multiple users support parallel publishing, allowing two or more users to publish at the same time. ๐Ÿ‘‰ Learn more about SmartTips

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:

  1. In the WalkMe Editor, open the filter options (such as publishing status or segment)
  2. Select the items you want to publish, or click Select All
  3. 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

Orange circle

Draft The item has not been published to the server.

Green circle

Published The item is published and has not been changed since.

Empty green circle

Modified The item is published, but has been changed in the editor. Republish to update it.

Grey circle

Archived The item was previously published but has been removed from the server.

Note

An item's status may differ across environments. For example, a Smart Walk-Thru could be published in test but remain a draft in production.

Switching environment views

In the editor, you can switch between environments to see the content and publishing states for each.

To switch environments:

  1. Open the environment selector in the top bar of the editor
  2. Select the environment you want to view
  3. Review your content in that environment

Publishing settings

You can publish changes to settings without publishing other items.

To publish settings:

  1. In the WalkMe Editor, go to Settings
  2. Select System settings
  3. Click Publish settings
  4. Confirm the environment and settings
  5. Click Publish to [environment]
Publishing settings

Publishing settings includes updates to:

  • System settings
  • Styling and integrations
  • Menu Organizer
  • Search providers
  • Dynamic text attributes
  • Segmentations

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:

  1. Select the items in the editor
  2. Click Archive at the bottom of the screen
  3. Review the summary and confirm
  4. Click Archive from [environment]
Tip

If changes don't appear right away, refresh the editor twice.

Unarchiving items

To restore an archived item:

  1. Open the Options menu next to the item
  2. 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
Delete confirmation popup.
Note

Items in folders must be deleted individually.

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.

Was this article helpful?

Thanks for your feedback!

Be part of something bigger.

Engage with peers, ask questions, share ideas

Ask the Community
×