Automatically Sync Divi Image Module Alt and Title Fields with the Media Library

Written by Dan Mossop

In this post, we'll cover how to dynamically sync the alt and title attributes of the Divi Image Module with the information stored in the WordPress Media Library. This enhances accessibility and SEO by ensuring the correct use of image attributes.

While Divi will retrieve the Image Module’s alt text and title fields when the image is first added, it doesn't keep them synchronized with the Media Library as the alt / title text are added or changed. Users have to manually update these attributes, which can be cumbersome. 

Furthermore, if you're adding images using dynamic content (e.g. from an ACF field), then the image attributes are not retrieved by Divi at all. 

Automatically Sync Divi Image Module Alt and Title Fields with the Media Library using PHP

Here's a PHP solution that ensures the alt and title attributes of images in the Divi Image Module are automatically updated based on the Media Library settings. This code can be added to your child theme's functions.php file or via a plugin like Code Snippets.

add_filter('et_pb_module_shortcode_attributes', 'db_add_image_alt_and_title', 10, 3);

function db_add_image_alt_and_title($attrs, $content, $module_slug) {
	
	if ($module_slug !== 'et_pb_image' || empty($attrs['src'])) {
		return $attrs;
	}

	// Look up the image attachment id
	$image_id = attachment_url_to_postid($attrs['src']);
	if (!$image_id) {
		return $attrs;
	}

	// Retrieve the alt text
	$alt_text = get_post_meta($image_id, '_wp_attachment_image_alt', true);
	if (!empty($alt_text)) {
		$attrs['alt'] = $alt_text;
	}

	// Retrieve the title text
	$title_text = get_the_title($image_id);
	if (!empty($title_text)) {
		$attrs['title_text'] = $title_text;
	}

	return $attrs;
}

By adding this PHP code, you ensure the alt and title fields of images in the Divi Image Module are dynamically kept in sync with the Media Library, improving accessibility and SEO. This method simplifies the process and maintains consistent image attributes across your WordPress site.

We may earn a commission when you visit links on our website.

Streamline PHP Code Integration with Divi!

Effortlessly add and manage PHP code in your Divi layouts with the Divi PHP Code Module. This tool enables dynamic functionality and automation, enhancing your site's performance and SEO. Perfect for integrating solutions like syncing image attributes with the Media Library.

Latest Posts

Fix the Flickr Typo in the Divi Social Media Follow Module

Sometimes it's the small things that make the difference... there is a minor typo in the Divi Social Media Follow module that was present in Divi 4, and (currently) remains in Divi 5. Specifically, the tooltip for Flickr is misspelled as "Flikr". Here's how to fix...

Add a Frosted-Glass Background Blur in Divi

Give your Divi layouts a polished, glassmorphism look by blurring the content behind a semi‑transparent Divi section, row or module. This effect enhances readability over busy or textured backgrounds while preserving the visual impact of your imagery and layout. In...

Customize Lightbox Title Styling in the Divi Gallery Module

Adjust the appearance of the lightbox title that appears when visitors open images from a Divi Gallery to align with your brand and improve readability. Refining the title’s color, size, and weight enhances visual hierarchy, accessibility, and overall polish. In this...

Center the Lightbox Image Count in the Divi Gallery Module

Centering the image count in a gallery lightbox creates a cleaner, more balanced presentation and makes it easier for visitors to see where they are in the image set. This simple visual tweak can enhance readability, especially with larger images and longer captions,...

About Dan Mossop

Dan is a Scottish-born web developer, now living in Brisbane with his wife and son. He has been sharing tips and helping users with Divi since 2014. He created Divi Booster, the first Divi plugin, and continues to develop it along with 20+ other Divi plugins. Dan has a PhD in Computer Science, a background in web security and likes a lot of stuff, 

2 Comments

  1. Thanks for this piece of code. It saved me half an hour. :)

    Reply
    • Hey Kris, glad to hear it helped! If there's anything else you need help with, just let me know. Cheers!

      Reply

Submit a Comment

Comments are manually moderated and approved at the time they are answered. A preview is shown while pending but may disappear if your are cookies cleared - don't worry though, the comment is still in the queue.

Your email address will not be published. Required fields are marked *.