Requirements for Using Appcues
This article covers what is needed for using Appcues effectively, as well as common conflicts Appcues can run into.
In order to use Appcues, you need three things:
- A web application that your users can access using a web browser.
- The ability to install a snippet of code into that application.
- Google Chrome (for authoring). Don't worry, we support a wide range of browsers for your end users (see more below).
Most websites will fit these requirements, but keep reading if you have additional questions or concerns.
Your application must be accessible over the internet by a URL. If you're not sure, you can use isUp.me to test your site out.
Creating Appcues flows:
Google Chrome is the only browser we support for authoring (or creating) your Appcues content. To create your flows, you'll need to use the Appcues Chrome Extension, which will allow you to create flows directly on top of your application.
If you already have the Chrome extension and are ready to get started building flows, check out some of our other helpful documentation.
Viewing Appcues flows:
- Most versions of Chrome, Safari, Firefox and Edge
- Internet Explorer 11
- Checklists and slideout backdrops are not supported on IE11
- Hard and Soft Spotlight are not supported in both Safari and IE11
In addition to the above, Appcues does not work particularly well on web applications:
- that are composed of many iframes. Not sure what an iframe is? Learn more here!
- using SVG elements. This affects tooltip and hotspot placement, as Appcues cannot attach either one of these step patterns to SVG elements or any elements nested inside those SVG elements. This can also affect Click-to-track events that track clicks on elements that overlap with SVGs.
- that rely on elements in a "shadow dom". This affects tooltips and hotspots, but not modals or slideouts.
- where the URL does not change as the user navigates
- built on Magento platform or built using Polymer or use prototype.js
- is a progressive webapp or desktop application
- that have the CSS zoom property applied. This is a non-standard CSS rule, and Appcues is unable to detect elements using this rule.
- that use Material UI (MUI) Select
- Instead, enable native prop select. Otherwise, the Material UI component won’t let the click event access and work with other libraries. However, the same behavior doesn’t apply for Select’s items, so events will work on items as expected even without the native prop enabled, they just won’t work on the Select’s wrapper.
When you’re trying to build a flow or event on a dialog that uses Focus trap APIs, inputs in the builder can’t be focused, making the builder unusable. This is due to the API’s aggressive focus handling, which is considered an accessibility feature. Note that setting those configs affects accessibility on your site (not Appcues content) since focus will no longer be trapped within the dialog in question
- for Material-UI’s unstable TrapFocus API, it could be overridden on your site by setting disableEnforceFocus to true.
- for MS Fabric’s (now also named as Fluent-UI) Accessible Popup props, it could be overridden on your site by setting isClickableOutsideFocusTrap to true and forceFocusInsideTrap to false.