Skip to main content
Image widget

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

Radovan avatar
Written by Radovan
Updated over 2 months ago

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

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


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?