Drupal is a registered trademark of Dries Buytaert
Protected Pages 3.0.0 Major update available for module protected_pages (3.0.0). Commerce Core 3.3.8 Minor update available for module commerce (3.3.8). Search API HTML Element Filter 1.0.7 Minor update available for module search_api_html_element_filter (1.0.7). Layout Builder Reorder 2.0.1 Minor update available for module layout_builder_reorder (2.0.1). Ban 1.1.0 Minor update available for module ban (1.1.0). Field Formatter Range 2.0.0 Major update available for module field_formatter_range (2.0.0). Field Formatter Range 8.x-1.8 Minor update available for module field_formatter_range (8.x-1.8). Varbase Media Header 9.2.1 Minor update available for module varbase_media_header (9.2.1). Search API Solr 4.3.11 Module search_api_solr updated after 14 months of inactivity (4.3.11). Provus Mega Menu Module provus_mega_menu crossed 1,000 active installs.

Background Image

693 sites Security covered
View on drupal.org

This module allows administrators and developers to implement background images on their Drupal site. It also offers the flexibility for users to attach their own background images to entities. The module is evolving to leverage other Drupal core modules for more advanced control and rendering of background images.

If your site is designed around utilizing background images, then this module is for you! Whether you need a surgical implementation that only administrators/developers can implement or provide the ability to allow users to attach their own background images to entities, this module has you covered.

Installation/Documentation

There is an highly detailed blog post dedicated to the installation of this module:
https://tag1consulting.com/blog/background-image-new-drupal-8-module

Background image is being modified to use the Context module and Media modules (together with Responsive Images and Image Styles) to control which background image is used for a given page and how it is rendered. At the time of writing, everything in the above blog post is still accurate, but in addition to what is said there, installing the Context module and setting up a reaction that modifies the background image will override which image is used. Before the next major release, the Context will become the only way to control which background image is used (with an event available for modifications by other modules) and an upgrade hook will make the change straight forward. The new configuration method is working locally but there's plenty of cleanup to do and tests to write.

Soft Dependency

  • Inline Entity Form - Currently required if you wish to embed the background image form on other entities.

Recommended Modules

The following are a list of recommended modules that you may find useful when working with this module:

  • Advanced CSS/JS Aggregation - Useful for minimizing the generated CSS for each background image.
  • ImageMagick - Useful in cases where PHP memory limits bug out due to large image processing.
  • Image Style Quality - Useful for further optimizing the preload background image style quality (recommend configuring somewhere around 30%)
  • Image Optimize - Useful for further optimizing all background images (progressive loading)
  • Token - Provides a way to view which tokens are available to use when adding overlay text for a background image.

Optional Modules

The following are a list of optional modules that you may find useful depending on some of your requirements/use-cases:

  • Image Effects - Useful for altering image styles even further with various effects.

Activity

Total releases
1
First release
Aug 2025
Latest release
11 months ago
Releases (12 mo)
1 ▲ from 0
Maintenance
Slowing

Releases

Version Type Release date
3.0.x-dev Dev Aug 3, 2025