Image widget

Find out how to add images to your Immerse pages

Radovan Vidović avatar
Written by Radovan Vidović
Updated over a week ago

Add images

Step 1: Choose Edit content from the Immerse editor tab:

Step 2: Place your cursor where you want to insert an image, then select the Image widget:

Step 3: Now choose to upload an image from:

  • Your computer

  • From a web link (URL)

  • Your Company Image Library

  • Search for a new image via our integrated image library

  • Upload history

From your computer

  1. Either click on the Arrow, drag the image from your computer into the area displaying "Drag and drop media your file" or click 'here' to select a file from your computer

  2. Your image will be added to your Immerse page.

From a URL

  1. Select the URL from the menu on the left of the upload window.

  2. Obtain the URL for the image that you want to upload and paste this into the link text box.

  3. Press the Upload button.

  4. Your image will be added to your Immerse page.

Note: Please bear in mind when uploading bigger file size images as they may have a negative user experience due to loading large assets.

From your company Library

Note only Admins can upload images and videos to your company’s library. These will display in the respective library tab in the image/video widgets and are available for any user in the company. This makes it easier for users to create Docs that are more consistent and on-brand. If you are not an Admin you will see the same screen as below but without the option to upload to the library.

From the Web

Turtl is integrated with Pixabay (a free stock image website), allowing you to search for images without leaving the Turtl editor. All images available are licensed under Creative Commons CCO, which makes them safe to use without asking for permission or giving credit to the artist - even for commercial purposes.

  1. Type in your keyword and press enter

  2. Click on the image you want to use. 

  3. The image will be added to your Immerse page

From upload history

When you add an image it will show you all the relevant media that you've previously uploaded to Turtl Docs. Additionally, you have the option to remove the images by hovering over the image you want to delete and selecting 'remove from history' to remove it.

Recommended File Types

Photo: JPG

Graphic: PNG

Animation: GIF

Movie: MP4, OGG, WEBM

Image Compression

Turtl automatically compresses all uploaded images to ensure that your content loads as fast as possible for your readers. 

Your image will retain its original format where possible but may be converted to JPEG if a small enough file size cannot be achieved any other way.

 If you find that your image appears blurry or low-quality, you can turn off our compression system by un-ticking the Optimize option.

However, please note when not using compression you should try to optimize your image for web use. Uploading images that are over 400Kb can load slowly for readers.

Image Dimensions

Any images uploaded must fit the required dimensions of your page. For further details on dimensions, check out the following article Dimensions in Turtl

Watch a video on the image widget

This 7-minute video covers:

  • Options for uploading an image into Turtl

  • Pinning and repositioning the image in Turtl

  • How to add a caption to your image

  • Utilizing “Fill Frame”, “Crop,” and “Zoom” functionalities to amend images for different layouts

  • Amending images for mobile readers

Image Widget Configuration

Check out this support article to learn how to change your Image Widget configuration to better adjust the image to your Turtl Doc!

FAQ: Can Turtl integrate with DAM (Digital Asset Management) tool?

Turtl Docs can appear in DAM (e.g. Paperfly), but pulling in images, videos, PDFs, etc. from a customer’s DAM to Turtl is currently not supported, as Turtl’s media library does not offer features like filtering, labeling, categorization, search, etc. that would typically exist in a Digital Asser Management tool.

As a workaround, we suggest using DAM in tandem with Turtl, e.g. you can have DAM open in a separate tab, search for an image, video, or PDF, grab its URL, and then paste that URL into a Turtl Doc (image widget, PDF widget, and video widget all support adding assets via URL).

Did this answer your question?