Adding Images and Files


Upload and insert image files into your book.

  • Upload the image file to the Media Library.
  • Images must be one of the following: JPG, PNG, or GIF.
  • Once the image is uploaded it becomes available in the book’s Media Library.

Image Upload

  • Got to Add Media
  • Select upload
  • Drag and drop your image or navigate to the file and upload.
  • You can select multiple image files at the same time.
Add your alt text here
Figure 1. Use the caption box – Image info goes here.

Add to Your Chapter

  • Place your cursor where you want the image to be placed.
    • Got to Add Media
    • Select Media Library
    • Find your image and select to insert into the book.
  • Add your image caption using the image caption function.
  • Add the credit and alt text for your image in Image Details.
  • You can also adjust the alignment and size of your image in Display Settings.
Figure 2. Screenshot of the Image Editing Screen

Editing Your Image

Select the image to highlight.

  • Alignment options and a Pencil become visible.
  • Select the pencil to open the image edit screen called Image Details. See Figure 2.
Figure 3. Screenshot of pencil edit option.

Add Alt text[1]

Alternative (Alt) Text is meant to convey the “why” of the image as it relates to the content. It is read aloud to users by screen reader software, and it is indexed by search engines. It also displays on the page if the image fails to load, as in this example of a missing image.

  • Add alt text all non-decorative images.
  • Keep it short and descriptive, like a tweet.
  • Don’t include “image of” or “photo of”.
  • Leave alt text blank if the image is purely decorative

Other File Types

  • Upload PDFs, PowerPoint slides, Excel spreadsheets
  • Benefit: The file is now stored inside the book – providing stable access.
  • Copy and use the internal URL.
  • Readers will be able to click on the hyperlink and read or download the file.
Figure 4. Screenshot of Copy URL to clipboard.

The steps to add files and link to them:

  1. Click “Add Media” at the top of the Visual Editor in Pressbooks.
  2. Select the Upload Files tab and select the file you want to upload.
  3. Click “Insert into chapter.”
  4. The link text can be edited – remember to make it meaningful.

Optimize images for web and print

If your goal is to produce a book for both web and print delivery, image set up and placement must be considered. It is recommended that all images are centred and that image size is no more than 500 pixels wide and 600 pixels high.

Using a larger image can potentially push it to another page in the PDF—sometimes several pages away from its webbook position. One solution for this problem is to add page breaks to key spots in the book.

Some authors choose to create a separate version, PDF, or other file type or different system such as InDesign, for print so that text and image layout for the web version can be more creative without having to take into account constraints needed for print.

Image attributions


Image captions



  1. Alt text section adapted from: Harvard University. (n.d.). Write helpful Alt Text to describe images. Digital Accessibility.


Icon for the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License

NSCC Pressbooks Guide Copyright © 2024 by Nova Scotia Community College is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License, except where otherwise noted.