Skip to main content

Image widget

Find out how to add images to your Content pages from different sources

Updated this week

This article outlines how to add an image to Content pages from different sources (your computer, web URL, image library, etc.), outlines supported file types, and details Turtl's image compression and other settings.

Add an Image widget

  1. Click the "+ Add content" button.

  2. Select "Image" from the Content menu.

Now choose to insert 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

  • Images from source PDF

  • AI images

From your computer

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

  2. Your image will be added to your Content 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 Content 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 Library

Note: Only Admins can upload images to your company’s library. These will display in the respective library tab in the image 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 above, but without the option to upload to the library.

  1. Select "Library" from the menu on the left of the upload window.

  2. Search your library by filename or by what’s actually in the image using our Intelligent image search! Need a marketer with glasses? Just type it in, and we’ll find the best match.

  3. Click on the image in your library to add it to your page.

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

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 Content page.

From your 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.

From source PDF

If you started creating your Turtl Doc by importing a PDF, this is where you’ll find the images that were automatically extracted from that file. You can reuse them in your content as needed.

AI Images

Generate on-brand media by training bespoke AI models using your pre-approved media library. Learn how to train your AI models and use them for image generation here.


Recommended file types

Photo: JPG

Graphic: PNG

Animation: GIF

Movie: MP4, OGG, WEBM

Using GIFs in the Image widget

You can upload GIFs using the Image widget in Turtl. When added, GIFs will play automatically as soon as the page they are placed on is viewed—no need for readers to click anything.

This is a useful way to show simple animations or short loops directly within your Doc content.


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 unticking the "Optimize" option.

However, please note that 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.


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!


Image editing with Hatch AI

If you want to tweak any of your generated images or you want to reuse an old image but change it slightly, you can use Hatch AI.

To edit an image with AI, simply right-click on the image in the Editor Preview and select “Edit image with AI”.

Add a prompt describing how you would like the image changed, click “Edit image”, and Hatch will update the image for you.


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 Asset 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?