The Complete Guide to WordPress Image Caption

Appearing beneath your image, a caption serves as the description of your visual document. It lets users know what your image is about as well as the source of the attribution.

You may be surprised by how easy it is to add image captions in WordPress using its default feature. Aside from that, you can also display image captions using Gutenberg and Divi page builders.

In this article, we’ll give you a detailed guide on each method along with a solution to add captions to featured, gallery, and WooCommerce product images.

Let’s jump in!

Why Using WordPress Image Caption

There are a few reasons for adding credit to your website images. Images inserted in between content without captions or descriptions may confuse users so the caption will help describe what the image is about. This makes your image more meaningful.

You can easily spot image captions in online newspapers and magazines as well. They can be the places your images are taken or the title of the photos.

Plus, captions can work as the copyright notice or attribution licenses of your images. They showcase photographers’ detail. This prevents others from stealing your artworks and reusing them without permission in other places.

What’s more, if you wish to use images from other sources, providing the credit also helps save you from legal issues related to violating copyright policies.

How to Add WordPress Image Captions with Page Builders

You have multiple ways to present the credit of your images, depending on the page builders you’re using. Besides the default caption feature by WordPress, you can also add image descriptions using Gutenberg and Divi.

#1 Use Built-in WordPress Caption Feature

Anytime you upload an image to your Media Library then add it to the content, WordPress gives you an option to give your image a description in the Attachment Details section. Simply open the page or post that you want to display captions under its images.

Next, click on Add Media at the top of the page toolbar and you will have an option to insert an existing file from the library or upload new files.


Once you check on the desired image, it shows you an Attachment Details section on the left side with important information about the file. You can fill in in the image’s Alt Text, Caption, and Description fields.


The ‘Alt Text’ works as a brief description of your image to let visitors know what the image is about when they can’t load it. The ‘Description,’ meanwhile, also describes your images, and at the same time, is displayed on the image’s attachment page. You should optimize them for better ranking on Google Image results.

The ‘Caption’ field will show at the bottom of your image which is visible to all users. The text can be the author’s name or background about your graphic. This is what visitors see when landing on your page:


#2 Adding Image Captions in Gutenberg

Developed by the WordPress team, Gutenberg brings a native page builder to your WordPress site without the help of a third-party plugin. Its mission is to replace the classic editor, become a revolution of WordPress content edition.

The page builder’s blocks make it easy for you to build your site without having coding knowledge. Out of the box, it just takes you a few clicks to add a caption to your photo.

All you need to do is insert the image block into your page. After that, click on the option to write a caption at the bottom of the photo. Since you can edit and see the caption in real-time, this method proves more convenient than the library method above.

Plus, it’s possible for you to modify the text font such as bold or italics which is not available in the ‘Media Library.’

#3 Display WordPress Image Captions in Divi

Divi appears as one of the most popular WordPress page builders, along with Elementor and Visual Composer. Its drag-and-drop interface enables web designers to edit and visualize the live page with ease.

Unlike Gutenberg, Divi doesn’t come with a built-in caption field along with the Image block. Instead, you have to use its Text module. Follow the guide below to quickly display a caption under your image.

First, edit your page using the Divi Builder and click on the ‘Add Image’ option.

After you pick your image from the library, click on the 3 dots and select ‘Edit as HTML’.

Next, copy the code of the image which is shown as follow:

<figure class=”wp-block-image”><img src=”” alt=”” class=”wp-image-108”/><figcaption> My image caption </figcaption></figure>

Paste the code into your Text Settings and you’re done.

Add a Caption to the Featured Image

Not only can you present captions under images in the content but you can also display post featured image caption. This feature is offered by the free Featured Image Caption plugin activated on your WordPress site.

As the name indicates, Featured Image Caption comes with only one feature, displaying a caption under your feature image in a post or page. The plugin works well with most themes and plugins and doesn’t require any coding skills.

To get started with the plugin, you just need to:

  1. Go to ‘Plugins’ → ‘Add New’ in your WordPress dashboard
  2. Type “featured image caption” in the keyword box
  3. Install and activate the plugin
  4. Head to the ‘Post’ and edit your desired content
  5. Click on ‘Set featured image’ in the ‘Featured image’ section and select your image
  6. In the ‘Featured Image Caption,’ enter your caption text
  7. Update your post

That’s it!

Display Product Image Gallery Captions in WooCommerce

Thanks to the Gallery Captions for WooCommerce add-on, you now have the ability to add a caption to your product image gallery effortlessly.

Since this is a paid add-on, you can’t search for it on the WordPress repository. Instead, you can download the plugin from the WooCommerce site. Then upload its file by going to PluginsAdd NewUpload Plugin.

There is no configuration needed. Upon activation, open your product page and insert images there. Similar to adding images from the library to pages and posts, you’ll see a field to write a caption.

Ready to Insert Captions into Your WordPress Images

There are a couple of reasons to show credit for photos on WordPress sites. Besides the image description purpose of making users understand your images better, they also work as the image credit. This helps you avoid violating copyright rules.

You have various ways to add a caption to your image. You can do that in WordPress classic editor, Gutenberg, or Divi page builder. We’ve walked you through the steps on providing captions for featured images and WooCommerce product galleries too.

Are you ready to add captions to your photos? Does any step above confuse you? Let us know in the comment section below.