Note: Launchers are currently only available in Beta. Please email us if you're interested in access. 

Creating a Launcher

You can create and manage your Launchers from the Chameleon Editor by clicking the Launchers icon. 

Once you open the Launchers section, and hit 'New Launcher' then you will see option for pre-configured templates, for common use cases. You can hover over these templates to see a preview of the Launcher on the right-hand side before picking one. 

Once you've selected your template, your Launcher is created, and you'll see the Launcher View in the Sidebar. You'll notice there are a few different sections:

  • Configure -- set the styling and interaction behavior for the Launcher
  • Tours -- decide which tours should be within this Launcher
  • Who should see this? -- set which users should see this
  • Available on -- set any domains to blacklist from showing the Launcher

Configuring styling and interaction

Once you click "Configure" you'll be moved into the Chameleon Launcher Editor (topbar) where you'll see all the configuration options. 

The two tabs available at the top are for the 'Widget' and the 'Menu'

WIDGET configuration

The Widget is the target which will open the Menu (the window that contains the list of tours). You can set the following configuration for this:

  • Trigger: whether a user needs to click or hover over the target to open the Menu
  • Widget Type / Target: you can choose a default icon, upload your own, set custom text or select an existing element on your page, to open the Menu
  • Position: this is available if you use an icon for the Widget. If you choose an 'Element on page' then there is no positioning needed. 
  • Axis adjustment: you can manually adjust the position of the icon, by using px or % values
  • Colors: if you selected an icon then you can change the colors for this

Note: you can also use our Launchers API to trigger the opening of the Menu without the need for a widget at all. 

MENU configuration

The Menu contains your list of tours, and other components, such as the Search bar. You can configure the following things:

  • Content: you can click into the Menu title to directly edit the Header copy
  • Widget and Height: you can set the width and maximum height for the Menu window. The window height will resize to fit the number of tours displayed until the maximum is reached. 
  • Colors: for the background and text
  • Checklist: you can choose to show checkmarks adjacent to Tours once they have been completed
  • Search: you can decide whether to show the Search bar in the Menu or not. This is great if you have a lot of Tours. The Search will return matches for any content (Tour title, Step body text etc.). 

RULES configuration

You can decide which pages to display the Launcher here. Read more about URL and element targeting here

EMPTY STATE configuration

You can choose to either:

  • Hide the Launcher when there are no Items in the Launcher (see below on how to remove Items from the Launcher once completed)
  • Retain the Launcher but show an empty state inside the Menu. You can edit the copy of this empty state here. 

Navigating and Preview

Once you have adjusted your styling and interaction behavior, you can click 'Preview' in the top-right side of the Topbar to view how the Launcher will behave for users. 

Note: if you click into a Tour from the Launcher Menu then you will enter the Preview for that Tour. If you then click 'Edit' you will have the choice to edit that Tour or return to editing the Launcher. 

Targeting Users

You can select which users should see this Launcher, by creating a segment of users, based on data about them, including attributes, events, Tour interaction etc. 

This follows the same pattern as creating a target audience for a tour, and you will see the same segments in this list as you do in the Target Audience section for any Tour. 

Learn more about how to create a target audience here

Adding items

You can add Chameleon Product Tours, URLs and Surveys to your Launcher. 

Once you've clicked "New Launcher item" you will see a modal where you can select the Tour / URL / Survey to add, along with other configuration settings:

Here you can adjust the following items:

  • Title and description; this will appear in the Launcher to your end users. If you don't add a description then some default info will show. 
  • You can select whether to show the Item to a subset of the users that will see the Launcher. This way you can have a single Launcher (e.g. for feature updates) with different items for different user groups (e.g. by rights / access to those features)
  • Persistence: you can choose whether to have the Item be removed once it's completed. A Tour is completed when the last Step is completed; a URL is completed when the link is clicked; a Survey is completed when a user responds to the survey question. 

Note: you can decide what to display if all Launcher Items are removed in the Empty State state (see above).

Manual Tours as Items

Chameleon Tours can be delivered Automatically (based on target audience) or Manually (from a Launcher or Link). Read more about that here

Only live Manual Tours will be available to add as Items within a Launcher. If you want to use an Automatic Tour within the Launcher, then duplicate it and set the Delivery Method to Manual and Activate the Tour. 

Note for older Tours with dynamic, partial or wildcard URL matching

if the first step of a Tour is configured with a partial or dynamic URL match (e.g. using a regex or wildcard) then the 'Additional Sharing Options' (available at the bottom of the Tour View) for that Tour need to be configured before that Tour can be selected here. 

If the 'Copy tour link' button is disabled, then please fill in the first field 'Define a URL..". 

In this section, you can also define the display name and display subtitle for the Tour within the Launcher. This helps you separate the title of the Tour, which can be used for internal organization and the display text. 

Going Live

The Launcher will only go live after you hit "Activate" in the 'Review and activate' section. Once activated, you can deactivate the Launcher from this section also. 

No engineering or coding is required, as the Launcher will use your existing Chameleon installation. 

Did this answer your question?