Skip to main content
All CollectionsCreation - ElementsMedia-based elements
How do I upload or import images to a topic or article?
How do I upload or import images to a topic or article?

You can add images to any topic or article - upload your own images or select from our image library, as well as edit images online.

Lou Monsour avatar
Written by Lou Monsour
Updated over a week ago

Images can be used within your topics or articles to explain or demonstrate knowledge, or simply to add something visually interesting or colourful.

Some ideas for including images are:

  • Provide a flowchart or visual representation of your knowledge.

  • Present a table.

  • Display a picture of a tool.

  • Provide examples or variations.

  • Show a graphical representation of your knowledge.

  • Visually break up points with lots of text.

Note: An alternative option for including images in your courses is to use the Hotspot element (to include an interactive image). Hotspot images allow you to overlay images with labelled markers for learners to explore.

Expand the following sections for more information.

Steps to add images to a course

Add the element to your topic or article by selecting the 'Image' option from the Content box, then follow these steps:

  1. Optionally provide a description for screen readers.

  2. Optionally open the image editor to edit your image.

  3. Optionally add a caption to your image.

  4. Click Save.
    Your image is now ready for learners to view within your topic or article.

    When clicked by learners, the image will zoom to show a larger version of the image, without the caption. Please note, only images added using the Tribal Habits image uploader support click-to-zoom functionality. Images inserted into text cannot be zoomed.

Video demonstration

In the video below, we explain how you can add images to your topics or articles. Please note, certain aspects of the UI have been updated since the video was recorded including updates to the Image Editor.

Settings and options

Option - Uploading your own images

If you upload an image, we recommend keeping the file size as small as possible. Each image should be around 50-100kb (and no larger than 5mb).

Images are automatically resized to fit, but you can instantly see how your images look onscreen to confirm its size. We support PNGs with transparent backgrounds and animated GIF files, as well as standard JPGs.

Option - Importing images from our image library

Alternatively, you can select our image library and then search for suitable images. There are over 2,000,000 different images in our library. Just enter a search term, review the options and import your image.

Option - Image descriptions for screen readers

After selecting an image from our library or your computer, you can optionally add a description and caption.

Descriptions describe the image for visually-impaired explorers, enabling them to hear the description with their screen reader. Tribal Habits supports all mainstream image readers.

Option - Editing your images

Whether you upload your own image or import an image from our library, you can edit your image online too. Click here to learn more about our image editor (to crop, annotate, filter, add frames, and much more).

Option - Image captions

Captions provide a caption to be displayed beside the image or as an overlay. After indicating the location of your caption (beside or overlay), you can specify the caption position (below, above, cover, left or right) and background (dark or light), if applicable.

  • Caption location: Choose to display your capture beside the image or as an overlay.

    - Beside: Specify if you want the caption to appear below, above, left or right of the image.
    - Overlay: Specify if you want the caption to appear as an overlay at the bottom (Below), top (Above), covering the image (Cover), or to the left or right of the image.

  • Caption position: When you select left or right as the location for your caption, you can also specify how much of the image element should be taken by the caption or how much of the image itself should include the caption overlay (25%, 50% or 75%). We recommend using a 50/50 split for smaller images or longer captions.

  • Caption background: For overlay captions, you have the option of a light or dark background, use your Primary or Highlight brand colours or you can select no background (None). We recommend editing the colour of the text to suit the selected background. For example, for a dark background, change the text colour to white.

  • Enable Image Styling: This setting is NOT enabled by default, by enabling this setting your image will have rounded corners added and a drop shadow applied.

To see how different caption configurations appear, please refer to the examples below.

Note: When adding captions to images, you have the option to edit the appearance of the text. For example, the font type, size and colour. We recommend changing the font colour to suit whether your overlay caption background is dark, light, or when you choose to have no background.

Best practices

Below are our recommended best practices when using images in your training content:

  • Crop your images - For example, if you use images as a way to break up points, we recommend cropping your image using the 'Header' ratio available when you click 'Crop shape' in our image editor. Likewise, for images used in Overviews, we recommend the 'Overview' ratio.

  • Use appropriate caption font colours - Update caption font colour to suit the background for example, use white or lightly coloured text for dark backgrounds.


Example - Captions beside images

You can add captions to your images with the choice of positioning them below, above or to the left or right of your image.



Left 25%:

Right 50%:

Left 75% with Image Styling enabled:

Example - Overlay captions

You can add captions as an overlay to your images with the choice of positioning them at the bottom (Below), top (Above), as a cover, or on the left or right side of the image with a light, dark, or no background colour.

Below (light background)

Above (no background):

Cover (light background)

Left 50% (light background)

Right 25% (dark background)

Example - Image cropping

You can use the image editor to crop images to the shape which best suits your requirements. For example, we recommend the "header" crop for decorative images. Other pre-set shapes include "portrait" crop.

Header crop

Portrait crop

Example - Image descriptions for screen readers

You can also write a description of the image to be read aloud by screen readers.

Did this answer your question?