If you would like to evaluate Guides and Surveys, please reach out to a member of your account team or fill out this form to be connected with a Fullstory team member.
Who can use this feature?
- Part of Guides and Surveys, an add-on for Business, Advanced, and Enterprise plans.
- Requires an Admin, Architect, or Standard role to configure.
Guides and Surveys is in active development. Product functionality and documentation may change without notice.
Guides and Surveys content supports embedded images and videos, allowing you to create richer, more engaging in-app experiences. Images can be provided via URL or uploaded directly. Videos are embedded from external providers such as YouTube or Wistia. Embedding media is supported in Tours, Smart Tips, and Banners.
This article covers the following:
Embedding images
To embed an image in a step or content area, click Insert in the editor toolbar and select Image. In the Insert/Edit Image dialog, you can provide an image by entering a source URL or by uploading a file directly.
Providing an image URL
In the Source field of the Insert/Edit Image dialog, enter the full URL of the image you want to embed. The image must be publicly accessible. After entering the URL, you can configure the following fields:
- Alternative description: Descriptive text for screen readers and for when the image cannot be displayed.
- Width and Height: The display dimensions of the image in pixels.
Uploading an image
Instead of providing a URL, you can upload an image file directly. Uploaded images are hosted at guides-cdn.fullstory.com. To upload, click the Upload icon next to the Source field, or click Upload and choose Browse for an image.
Image format and size requirements:
- Supported formats: JPG, PNG, GIF, SVG
- Unsupported formats: WebP, BMP, TIFF
- File size limit: Files larger than 1 MB are not supported.
-
SVG files: The HTML source editor strips
<svg>tags from inline SVG markup. To use SVG images, upload the SVG file rather than pasting SVG code directly into the source editor.
Embedding videos
To embed a video, click Insert in the editor toolbar and select Media. The Insert/Edit Media dialog has two relevant tabs: General for source URLs and Embed for provider-supplied HTML embed code.
Note: Video embeds from providers such as YouTube may require updates to your Content Security Policy (CSP) headers so the video can load in your application. See Configuring Content Security Policy (CSP) for Guides and Surveys for details.
Using a source URL
On the General tab of the Insert/Edit Media dialog, paste the URL of the video in the Source field. This works with publicly accessible video URLs from providers such as YouTube.
Using embed code
On the Embed tab of the Insert/Edit Media dialog, paste the HTML embed code provided by your video platform. Most video providers offer an embed code option in their video sharing or publishing settings.
Wistia
Wistia videos require additional configuration before they can be embedded in Guides and Surveys content.
Domain Restrictions: In your Wistia account, navigate to the video's settings and add the domain where your Guides and Surveys content will be displayed to the Domain Restrictions allowlist. Without this step, the embedded video will be blocked by Wistia's domain restrictions.
Embed code: Use the Fallback embed code from Wistia's Advanced Settings for your video. Paste this code into the Embed tab of the Insert/Edit Media dialog in the Guides and Surveys editor.
Frequently Asked Questions
What Guides and Surveys content types support embedding images and videos?
Embedding images and videos is supported in Tours, Smart Tips, and Banners. Checklists, Surveys, and A/B Experiments do not support embedded media.
What image formats are supported?
JPG, PNG, GIF, and SVG are supported. WebP, BMP, and TIFF are not supported.
Is there a file size limit for images?
Yes. Image files larger than 1 MB are not supported.
Why is my embedded video not displaying in preview?
If an embedded video does not display, your application's Content Security Policy (CSP) headers may need to be updated to allow the video provider's domain. See Configuring Content Security Policy (CSP) for Guides and Surveys for guidance on updating your CSP settings.
Can I embed images inline within text?
Yes. Images can be embedded inline within paragraph text, not only as standalone block elements.