Skip to end of metadata
Go to start of metadata
Complexity Level: Beginner

This is a beginner topic. Little to no advanced knowledge is required.

Permission Level


You can add and position images to pages on your Drupal 8 site where there is a text editor.

This works very similarly to our Drupal 7 sites, but it is easier to align images and add captions now.


Note on the Screenshots in this Document

This document shows screenshots from a site using the Franklin Vertical Theme, but the same steps apply to those using the Franklin Bold theme.

Table of Contents


Inserting large (oversized) images

1) Within the text editor, place your cursor where you want your image to appear.

I'm putting this image at the beginning, above my text.

2) Click on the icon that looks like a picture frame.

When you mouse over it, it reads "image."

3) Select a photo from your computer.

This image is 800 pixels wide by 621 pixels tall. 

For this particular theme, if the image is larger than 720x720, the text editor will automatically resize it to fit within those dimensions.

I see that the image has been resized. (For some reason the message appears twice. Ignore that for now.)

4) Add alternative, or "alt" text.

I wrote, "Young Margaret Hamilton adjusts some dials on Apollo II in a historic black and white photograph."

About alternative text

Alt text allows people who have visual impairments to understand what the image is about. You don't need to say "image of" or "picture of," but in this example I mention that it is an historic photograph, because I think that helps explain the significance of the photo.

If this were an artist's rendering of the planet Venus, I would say "An illustration of the surface of Venus..."

Modern headshots generally don't require alternative text, because the alt text would not provide any information that is missing to someone who can't see. I would just enter two quotation marks, which signals blank alt text.

5) If desired, align your image and select "caption" for captions.

Because this image is at its max size, 720px, I'm not going to align it. The image will fill the column. I'll show you how to align images that are smaller next.

You can add a caption, which is different than the alt text, if you wish. Once we save the image, we will see a place to add a caption beneath the image.

6) Click the save button

You will now see your image with your content.

7) Add a caption beneath the image if you selected that option.

8) Save your page and see what the image looks like with the theme.

The image resizes automatically no matter what device someone views the page with. 

This image is rather large and takes up a lot of space at the beginning of my content.

You may not want all of your images to go all the way across the content and take up so much space. You can use your favorite image editor to resize the image and then set its alignment.

Remember, for this theme the maximum dimensions are 720x720. I'm going to go to resize my image to be half the size of that.

Inserting and aligning smaller images

I'm going to click edit and add a resized version of this photo of Margaret Hamilton.

1) Within the text editor, place your cursor where you want your image to appear.

Again, I put my cursor where I want the image to appear-- this time, beneath the first paragraph-- and click on the picture frame icon.

2) Click on the picture frame icon.

3) Select a photo from your computer.

I select the resized image from my computer.

This image is less than half the width of the maximum width of 720 pixels. 

4) Add alternative text.

5) Align your image and, if desired, click to add a caption.

Notice that I don't get the green box telling me that Drupal and the text editor have resized my image.

I've added my alt text again, and I'm going to make this image float, or align, to the right. The text will wrap to the left.

I'm going to add a caption too, so you can see what it looks like.

6) Save

Here's what it looks like in the text editor.

Tip: If you need to go back and edit the photo's alignment or alt text, simply double click the photo within the text editor. 

7) Add a caption

8) Save your page and see what the image looks like with the theme.

I've saved everything, and here's how the image looks at a width of 350 pixels instead of the maximum 720. 

And here's how it looks compared to the first image I added, which was as large as it could be.

What if I want to insert an image that is already on the website somewhere?

At this time it is not possible to insert an image into the text editor region that has previously been uploaded. That functionality hasn't been fully fleshed out. You will need to download and re-upload the photo. 

However, if you are uploading an image using a field specifically for images, it is possible to use an existing image on the site.

For example, the Article content type has an image field specifically for the thumbnail.

I can either use "Choose File" to select a file from my computer, or I can use the "Open File Browser" link to access all images (and files) on the site.

I found the image of Margaret Hamilton that I previously uploaded to the Basic Page in the above examples, and I am using it for this article's thumbnail.

As when I insert images with the text editor, I need to include some alt text.

I've saved my Article with my thumbnail image.

Because this image was uploaded with an image field, there are some automatic alignments placed on the image to make it go to the right. 

This image appears cropped and resized in the preview version of the article on the News page.


To manage any part of your web site, you will have to be logged into the Drupal CMS.

If you need help logging in, please review this login help document. 

Contact the Franklin OIT Help Desk

Hours of Operation

Monday - Friday

8:00 a.m. - 5:00 p.m.

Website Information



Service Offerings

Systems Status Information

Franklin OIT Status

UGA/EITS Systems Status Pages

USG Systems Status Page