How to Create & Edit Tooltips

This doc reviews the basic steps of building a tooltip flow. For more advanced use: 


Creating Tooltips

  1. Open the Appcues editor; click Create and select Tooltips
  2. Your cursor is now in editing state to place your first tooltipt: as you move your cursor around the page, you'll notice it highlights elements you hover over with a blue outline
  3. Place your first tooltips on the element you're pointing to: get as specific as you can, though you can always re-position this later
  4. To add another tooltips, click Add > Tooltip in the bottom of your editor bar
  5. Continue adding tooltips until your flow is complete: once it looks good, click Target & Publish to edit your targeting rules before publishing your flow


Editing Tooltips

You can edit tooltips per-step, or make adjustments that affect your entire tooltip flow.


At the Step level, you can modify 

To access the tooltip settings, click the cog icon next to the tooltip you'd like to edit, or if the settings are already open select the of the step you'd like to work on. The settings bar will appear on the left side of the editing screen. 

Repositioning tooltips 

To reposition tooltips, select Reposition at the top right corner of the step settings. Your cursor will again start outlining the elements you can place your tooltip on.

If you notice the selector in your step settings is too general (or your tooltip throws an error/does not show up when published), you can enter more specific selector in the Selector field. Adjust where you'd like the beacon to appear accordingly by changing the numbers under Distance from left/top edge.

Tooltip arrow position

This controls where your text box will appear from in relation to the tooltip element. By default, your arrow is set for the optimal position (based on the browser size and where the element sits on the page), but you can select for your text to appear from other corners, the top, or the bottom of your chosen element.

Progress this tooltip when...

Tooltips by default include a Next or Close button to guide users all the way through your entire tooltip flow. There may be cases where you'd like your tour to continue or end as your user clicks an action element on your page instead. To remove the Next or Close button for an individual tooltip, opt to progress on click of "Element" (hides the Next button)".

Learn more about these action-driven tooltips  here.

Deleting tooltips

To delete a tooltip, click on the trash icon in the top of the step settings.



To access settings that will change a group of tooltips, click on the paintbrush icon to the left of your tooltip group. The settings will appear on the left side of the editing screen..


You can apply any of the themes you create at your Styles page to your flow. Select a theme from the  Theme dropdown and it will automatically apply its styling to every step in your flow.
Learn more about creating themes here.


Tooltips by default have no beacons, but if you'd like to direct even more attention to the elements you're describing you have two beacon styles to choose from: question-mark icons or circles. 

ProTip: You can create a theme with a pulsing beacon under your Styles page



If you'd like to draw even more attention and focus on the elements your tooltips are built on, choose one of the Backdrop options. 

Note: We are not able to provide the backdrop feature to IE 10/11 or Safari users due to browser restrictions


Places a radial focus on your element but allow your users to still click through on other elements on the page. 


clearly outlines the element your tooltip is attached to and requires your user to continue or complete the tooltips before interacting with your page.


Flows can be skippable or required for you end users.  

Skippable tooltips include an option for users to Hide these tips or a close X button. If you uncheck the Skippable box, these options will be removed and users will have to click through your entire flow to complete it.

Switch Preview Page

You can change the page you build or view your flow on by clicking the Switch Preview Page button. Once this button is clicked, you'll be able to navigate through your app normally. You can also use this button to open non-Appcues pop-ups or windows that you'd like to place tooltips on.

When you've found the page or elements you'd like to work on, select  Display flow on this page from the bottom bar on your screen.