How can I upload media to my Experiences?

Learn how you can add images, videos, or GIFs to your Chameleon Experiences

Sonia Schiau avatar
Written by Sonia Schiau
Updated over a week ago

Chameleon Experiences can be customized in detail to achieve a native blend, or to add context and value to your communication. You can upload photos, videos, or GIFs to deliver the right message and delight your users.

You can also easily launch videos from your buttons with our integrations, or via a follow-up Step, or Tour.

Availability & Usage

🔐 Available for all plans

📍 Add them to your Tours, Tooltips, Microsurveys, Launchers

Chameleon Experiences are built to help you communicate with your audience effectively and create a better in-product experience. Visuals are a big component of how people internalize information or experiences. And sometimes they make a difference in successfully driving the next action or behavior.

When customizing your Experience, you have different options to add visuals that complement your message and styling.

  1. Upload an image, video, or GIF by clicking the “Media” component in the Design section of the Builder.

  2. Launching videos via additional Actions, or as a follow-up Tour Step.

You can upload different image types (.jpeg, .png, or .gif) that will display in your Experience. In the same panel, you can also adjust its positioning and height, to make sure it fits your specific context and styling. The position of your visual will be relative to the Body component of your Experience.

To add a video to your Experience, select the same Media component to enter the URL from the site where your video is hosted, or use our Embed component available for Tours. You can add videos from a range of providers, including:

  • YouTube

  • Wistia

  • Vimeo

  • Loom

And update its position and size from the Builder.

👉 We use a third-party solution for embedding, so for a full list of providers please visit Embedly.

----------------------------------- update to match heading

Check out our native integration with Loom; enable it from the Dashboard to launch videos with a button click.


To keep your videos private, some video hosting services provide the ability to specify which URLs and domains the videos can appear on. To add Chameleon to your hosting services list of allowed URLs, be sure to update your allowed list with one of the options below:

  • The URL: //*

  • The domain

👉 If you want to leverage URLs with additional parameters attached we suggest you use our Embed feature or explore our native Loom integration.

Chameleon also supports GIFs, which essentially are image files that support animation. You can use GIFs to showcase something simple, create a simple delight moment for users, or provide quick references.

✨ For quick GIFs, you can use Kap (for Mac) or Gyazo (for Windows).

🤝 Remember to set an alt text to your visuals to make them accessible to all your users. Learn more about Accessibility in Chameleon.

If your visuals fall outside the ideal dimensions for your Chameleon Experiences, you can resize them to fit just right, using your device’s photo viewer.

  1. Choose Tools > Adjust Size

  2. Select Pixels from the unit dropdown menu.

  3. Enter new values for height (296px) and width (710px). Note: see below on how to maintain proportions.

  4. Click Ok to save.

Tips to get a picture-perfect result:

  • To ensure that the image keeps its original proportions, make sure “Scale proportionally” is checked. If you change either the width or height, the other value changes to maintain the proportions.

  • To make the image’s dimensions smaller without losing any detail, deselect “Resample image” before changing the width or height.

  • To resize multiple images at the same time, display the images in the same window, select them in that window’s sidebar, and then choose Tools > Adjust Size.

  1. Open Photo Gallery.

  2. Select the photos you want to resize, and then on the Edit tab, in the Properties group, click Resize.

  3. Click the Select a size list, and then select a size for your photos. For a custom size, in the Maximum dimensions box, enter the maximum width you want your photos to be.

  4. Click Resize and save.

  1. Start Paint and Open the image you want to resize.

  2. On the Home tab, in the Image group, click Resize.

  3. To resize the picture so it's a specific size, click Pixels, and then enter a new width in the Horizontal box or new height in the Vertical box.

  4. Click the Paint button, then Save.

You can leverage media components in your Experiences to set up additional Actions leading users to another Experience or to highlight features when they click your visual.

Configure these to follow the completion of your Microurvey, on a Tour Step, or within your Tooltip.

👉 See all the additional Actions you can launch from your Experiences.

You can also use the Media component to allow users to complete your Tour or Microsurvey, or progress to the next Step.

Aside from uploading videos in your messages, or launching them as additional Actions, you can also configure any Tour Step to deliver your video message -- simply use the Media component to add your video at max height and adjust the Canvas size to fit your video message so users can pleasantly view it.

📺 Check out the video below with some best practices for in-app videos:

Use visuals to deliver more dynamic and engaging Experiences. You can leverage media to complement your how-to explanations, or introduce new features with a quick 'what's new' video.

Want to know more?

Did this answer your question?