Welcome to the WalkMe Help Center

Please login in order to continue:

Work flows better with WalkMe
Work flows better with WalkMe.

Extension Settings in Admin Center

Last Updated November 18, 2024

Brief Overview

WalkMe's system management in the Admin Center lets you manage all your WalkMe systems from one accessible location. This article explains the Extension page in details.

Extension Structure

An extension is automatically created for each account, and any new system created is added to the extension but not activated by default.

Environment Configuration

Basic Settings

  1. To enable the system to load from extension, turn the setting toggle on
  2. The URL configuration will appear
  3. Provide the URLs for the websites on which you want WalkMe to load

After you configure the system's URL conditions and publish the editor content to the relevant environment, WalkMe will load on the web application. We use URL match patterns as the default syntax to define which URLs the extension should load on.

Each environment should have a unique web address based on the application. Two or more environments should not match the same URL to avoid potential conflicts, as only one environment can be loaded at a time.

Note

Extension settings may take some time to reflect changes after saving. Please pay attention to the popup message and the time mentioned in it after saving.

Advanced Settings

The Advanced tab contains a set of additional settings that apply to the selected environment.

  1. Load snippet first: Will prioritize the snippet (if already on page) and prevent extension from loading
  2. If snippet doesn't load, load the extension: Allows the extension to load with a small delay if the snippet doesn't load
  3. Load WalkMe on cross domain iframes: Allows extension to load inside cross domain iframes
    • Select "On specific domains" if the extension should only load on certain top domains

Configuration Sets

Additional configuration sets may be added on top of environment settings in cases where the environment is set up to behave differently on different domains.

Example

  • The production environment should load on domain_1.com and domain_2.com
  • Domain_1.com already has a snippet implemented, so the extension should not load on top of it
  • Domain_2.com does not have a snippet, so the extension should load as expected

This situation creates a conflict because WalkMe needs to be loaded differently on the same environment. To resolve the conflict, we enable the creation of several configuration sets for the same environment. Each set behaves independently and loads its own unique configuration.

Note

Configuration sets cannot be added from Admin Center and require assistance from WalkMe. Please reach out to your WalkMe contact if you wish to add it to one of the environments.

URL Verifier

The URL Verifier is a tool designed to help users ensure their extension is configured correctly and verify if a specific URL is handled by the appropriate system. It can help identify incorrect URL conditions to prevent situations where WalkMe doesn't appear on pages due to a misconfigured extension and find potential conflicts, such as when multiple environments incorrectly respond to the same unique URL within the same system. 

It can be found in the Admin Center on Extension tab if your system is configured to load from extension.

How it works

The tool is designed to validate a URL against the extension configurations across different environments in a selected system. 

  • It requires the full URL to work—partial URLs will not be recognized
  • The tool only checks environments where loading from an extension is enabled
    • Deactivated environments are skipped automatically

Important Note

If a URL matches conditions in more than one environment, a conflict warning will appear. This highlights potential issues, as only one environment can be loaded at a time. To resolve conflicts, adjust conditions in the additional matching environments to ensure unique environment assignments.

URL verifier options

The URL verifier has two options:

  • Application URL validation: Validates URL against condition in the Basic section of Extension settings
    • Results are displayed in the modal if a match is found
    • Click on the tile to view the matching rule, with an option to navigate directly to the extension settings where the match is located
  • iFrame URL validation: Advanced version of the URL validator relevant for systems where extension is configured to load inside cross domain iframe under specific Application URL
    • Allows users to validate the iFrame URL in combination with a specific Application URL - This ensures the correct system handles the content within the iframe under the specified conditions

Example

  • Application URL: what you see in the browser's address bar
    • https://www.walkme.com
  • Cross domain iFrame URL: iFrame embedded into https://www.walkme.com
    • https://iframe.url.com

Extension settings in this scenario look like this:

  • Basic: Holds the iFrame URL (where extension is expected to load WalkMe):

  • Advanced: Configured to match the Application URL (where the iFrame exists):

Note

  • "Load WalkMe on Cross Domain iFrames" must be enabled and specific site conditions should be added in this scenario
  • If the "On all sites" option is used, WalkMe will load inside the iFrame regardless of the URL

Was this article helpful?

Thanks for your feedback!

Be part of something bigger.

Engage with peers, ask questions, share ideas

Ask the Community
×