Issue

A WalkMe permalink isn't working as expected.

Solution

Work through the checks below to find the cause.

Permalink parameters aren't being preserved

Some sites cancel URL parameters on redirect. For example, going to https://www.yourdomain.com?walkme=12345 may redirect to just https://www.yourdomain.com, stripping the parameter. This is common on sites that prompt a login before redirecting.

This behavior isn't caused by WalkMe and can't be resolved on WalkMe's end. If this is happening on your own application, consult your site developers about modifying the redirect behavior to preserve URL parameters.

Permalink not set up correctly

Permalinks are structured differently depending on the item type. The parameter must always appear at the very end of the exact URL where the content should play.

• Smart Walk-Thrus: Go to the Initiators tab, then select Permalink
• ShoutOuts: Go to Options → Engagement → Permalink

Permalink needs to be adjusted

If the URL already contains a question mark ?, the WalkMe parameter needs to use an ampersand & instead.

This won't work:

https://example.com?settings?walkme=12345

This is correct:

https://example.com?settings&walkme=12345

Content not published to the correct environment

Confirm that the Smart Walk-Thru, Classic Walk-Thru, or ShoutOut has been published to the environment you're testing in. For example, if you're testing a permalink in your test environment, make sure the content is published there.

WalkMe isn't loading on the site

If no other WalkMe content is loading on the page where the permalink should work, WalkMe may not be loading correctly. Refer to the WalkMe Widget Isn't Appearing article for further troubleshooting.

WalkMe Widget Not Appearing