Requirements and Guidelines for Developers

To ensure that Userlane will run smoothly on your application, follow these guidelines as much as possible. 

They are recommendations from our Userlane IT Team. Should you have any questions regarding any of those points, do not hesitate to reach out to us.


  • The underlying app needs to run with an encrypted protocol (HTTPS) to ensure a secure and encrypted communication.
  • The underlying app does not use a plugin such as Adobe Flash or Microsoft Silverlight.

  • The underlying app does not register event callbacks in capture mode.

  • The underlying app does not remove DOM nodes that it does not recognize, especially DOM nodes added by Userlane need to remain untouched.

  • The underlying app does not modify native browser functions, for example with polyfills or XHR overrides.

  • The underlying app does not use framesets, or does not expect Userlane to highlight elements in a frameset.

  • The maximum z-index of the underlying app does not exceed 1,000,000.

  • Ensure Userlane is allowed by your Content Security Policy. Find more details on it here.

  • If a firewall is active, it has to be set to allow communication to Userlane servers.

  • Every client needs access to the internet to communicate with Userlane’s services.

  • Third-party cookies must be enabled. Find more details on what cookies are stored.

  • Based on the chosen implementation the supported browsers differ. Find more details on it here.


  • Handover of relevant user data, e.g. permissions of the current user, to the Userlane JS Snippet API. This allows you to show Guides more targeted to the end-users. Read more about this here

  • Do not use hover actions or make hover actions also accessible via click. When a hover menu closes on mouseleave that can cause issues in highlighting the elements reliably for Userlane.

  • Use relevant URLs that allow knowing what page the user is currently seeing. This helps you to show Guides specific to the page the user is currently looking at.

  • If your application uses Cross-Origin iframes, please review this article here.

  • Include semantic identifiers to relevant elements. 
  • We recommend using data-automation-id, data-test-id, data-userlane-id, data-userlane-role, or data-action-name attributes with semantic names (e.g. “createTutorialButton”, “deleteUserAction”). This helps you to make Userlane more stable regarding any updates in the HTML code of the application.
User Icon

Thank you! Your comment has been submitted for approval.