Using Shortcodes in the Background Image URL field

Written by Dan Mossop

The Divi Theme allows you to add background images to Divi Builder sections, rows and modules. By default, Divi doesn't allow shortcodes in the background image URL field. If you want to use a shortcode to generate your background image URL (or part of it), here's how to do it.

Adding a Background Image by Shortcode using Divi Shortcode Enabler

Divi Shortcode Enabler lets you use shortcodes in various places where Divi does not normally run them. As of Divi Shortcode Enabler v1.0.9, it supports shortcodes in the background image URL of Divi Builder elements. You can use it like so:

1) Enable Divi Shortcode Enabler.
2) Open the settings for the element (section, etc.) you want to add the background image to.
3) Click on the "Add Background Image" as shown:

4) Click "Insert from URL" and enter the shortcode which generates your background image URL. You can also use a shortcode to generate just part of the URL, as shown here:

5) Click "Insert into Post"
6) Save the Divi Builder element settings, and then save the page.
7) View the page on the front end and you should now see the background image generated by your shortcode. 

Some things to note:

* The background image doesn't (yet) display in the Visual Builder preview / module settings

* If you re-open the "Insert from URL" field you won't see the shortcode any more. However, it is still saved in the module and as long as you don't modify the "Insert from URL" field and click "Insert into post" button the shortcode will remain saved and continue to take effect.

* Divi caches the resulting background image URL in its CSS cache. If your shortcode can generate multiple different background URLs for the same page, then in order to see the correct background URL at all times you may need to disable the CSS cache at:

Divi > Theme Options > Builder > Advanced > Static CSS File Generation 

 

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

Unlock the Full Potential of Shortcodes in Divi!

Empower your Divi site with the Divi Shortcode Enabler. This plugin allows shortcodes to run effortlessly in various Divi module fields, including background image URLs, enhancing functionality and customization across your site.

Latest Posts

Top (or Bottom) Align Divi Icon List Module Icons

When Icon List items wrap onto multiple lines, the default icon alignment can make the icon appear vertically centered next to the text, which may look unbalanced or harder to scan. Setting the icons to align at the top creates a cleaner, more consistent...

Make Divi Button Modules Full Width with Centered Content

This configuration makes a Divi button stretch to the full width of its container while keeping its label neatly centered, creating a bold, edge-to-edge call-to-action. You might want this for hero sections, pricing tables, or any layout where a standard-sized button...

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...

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, 

0 Comments

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 *.