Skip to main content

How do I upload or import images to a topic?

You can add images to any topic - 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 2 weeks ago

Images can be used within your topics 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 topic


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

  1. Upload an image from your computer or select one from our image library.

  2. Add a caption to your image (optional).

  3. Provide a description for screen readers (optional but recommended).

  4. Open the image editor to edit your image - such as resizing or cropping (optional).

  5. Click Save.
    Your image is now ready for learners to view within your topic.


    When clicked by explorers, 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 element 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.

Please note: certain aspects of the UI have been updated since this 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 to ensure optimal load times for explorers. 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 the library or your computer, you can optionally add a description for screen readers.

This description helps visually impaired explorers understand the image by having it read aloud through their screen reader. Tribal Habits supports all major screen reader applications.

Option - Editing your images

Whether you upload your own image or import an image from our library, there are a range of editing options available. 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 (such as dark or light), if applicable.

  • Caption location: Choose to display your caption 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, 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.

  • Disable Image Styling: By default, images in Tribal Habits have rounded corners applied automatically, this is known as 'image styling'. Tick this option to remove image styling.

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.

  • Consider accessibility - Use the screen reader description field to describe images for visually impaired explorers. Avoid uploading images that include text within the image itself, as screen readers may not be able to interpret embedded text. Instead, provide any written information in captions or in the screen reader description field.

Examples


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.


Below:

Above:

Left 25%:

Right 50%:


Left 75% with Image Styling disabled:

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

Did this answer your question?