Images - Frequently asked questions

Answers for authors to frequently asked questions about images, re-sizing images and slideshows.

Caitlin Foran avatar
Written by Caitlin Foran
Updated over a week ago

We hope you’ll find the answer to your image questions below. If not, let us know via the in-app chat.

What size/dimensions should my images be?

Images can be any size or shape, but some image ratios and sizes work better than others across different devices. When an image is uploaded, iQualify and the browser you're using process and resize the image to deliver the optimised version of the image for the size device that the person is using.


  • For best inline viewing allow for a 16:9 ratio.

  • A standard 4:3 ratio will also work in many cases but will display more space around it.


  • To avoid infill on the top and bottom of the image, try to use images more than 500px high.

  • To avoid infill on the sides of the image, try to use images more than 2080px wide.

  • Images viewed using a hi-resolution (Retina) display, will display the image at half size if the image is less than 2080px wide.

What are these bars on the side of my image?

Where an image doesn't fill the optimal viewable screen space entirely, we use an automated backdrop fill called infill (a mix of the colours in your image). For instance, in our image of Jupiter below, you can see that the image has two tan coloured bars on either side because iQualify is auto-filling to the full width of the page.

Image of the planet Jupiter with tan coloured bars to the left and right of the image.

Infill happens because we need to be able to resize easily for lots of different devices.

How do I crop or edit images?

There are a number of free tools to crop, resize or edit your images such as: Pixlr x, Adobe Creative Cloud Express, or even Powerpoint or Google draw.

How do I add a caption or copyright attribution to an image?

After you have selected an image and uploaded it, you will see a box below your image. You can type in your caption into the top-most field, and add alt text or a copyright attribution.

Screenshot showing an uploaded image in the image/slideshow settings and the fields to enter a title caption, alt text and copyright attribution.

What is alt text?

Alt text (alternative text) is text that describes an image. It can be read aloud by screen readers, displayed if an image fails to load, and is also indexed by search engines. For this reason, you should try and make your alt text descriptive. What would someone who can't view the image need to know?

Check out Writing alt text for images for detailed guidance.

Why is the height of my slideshow bigger than my image?

Slideshows are multiple images, but these images can be varying heights. To be able to stack different height images in the same element, we need to set a minimum height for the slideshow. That minimum height is 516px. Any image with a height less than 516px will get automatic infill above and below.

Our top tip for slideshows is to resize images to the same dimensions or ratio. Any images that you can't resize to a minimum height of 516px, put a larger (ideally dark) background behind.

Why are image sizes in a slideshow smaller than an individual image?

Images can be smaller in a slide show compared to the same image as a singular image because the container size is different for these two areas.
Slideshows have a fixed container height and width, the maximum height is always 516 pixels high. So if the image is larger than either the maximum height or width, it is scaled down to fit. The container size is set to create a better visual experience.
A singular image is not height constrained, so the same image in a slideshow scaled down due to its height, will not be if added as an individual image (unless the maximum width has been exceeded).

Why can't I re-position the arrows on my slideshow?

The slideshow has automatic arrows which appear left and right of an image. The arrows are in a fixed position for a consistent visual and tactile experience. If you find that the arrows obscure content or a part of an image, you will need to take this into account when designing your slideshow.

Image of a slide show showing an image of ice seracs with arrows left and right of the image.

Why can't I add an image inside a text box?

iQualify is a responsive platform which means we need to be able to automatically resize images and have made some layout restrictions in order to make sure things look neat and tidy no matter what device users are on. When text wraps around images it can sometimes leave just a few words on the side of the image (depending on the users' screen). This makes the text really hard to read and to get a sense of the flow which gets in the way of learning. For this reason we decided to make all images full-width, as a separate element from text.

Why are images in tasks different?

In tasks you might need to include a small image to be dragged and dropped for example, so images in tasks work slightly differently:

  • You can crop, and rotate in the uploader before you insert the image.

  • You can resize using the drag handles on the edges of the image after you've inserted the image.

  • There is currently no in-built option for copyright attribution. We recommend inserting this below the image either with normal text or for a less-cluttered look you could:

    • add all image attributions in one page for the whole course, or

    • add a reference at the bottom of the page for attributions on that page.

What image file types/formats can I use?

Images can be:

  • JPEG

  • PNG (no background transparency)

  • GIF

See 10 Types of Image File Extensions and When to Use Them for more information on image file types.

Didn't find the answer to your question...?

Let us know via the in-app chat.

Did this answer your question?