Drupal is a registered trademark of Dries Buytaert
drupal 11.3.7 — Update released for Drupal core (11.3.7)! drupal 11.2.11 — Update released for Drupal core (11.2.11)! drupal 10.6.7 — Update released for Drupal core (10.6.7)! drupal 10.5.9 — Update released for Drupal core (10.5.9)! cms 2.1.1 — Update released for Drupal core (2.1.1)! drupal 11.3.6 — Update released for Drupal core (11.3.6)! drupal 10.6.6 — Update released for Drupal core (10.6.6)! cms 2.1.0 — Update released for Drupal core (2.1.0)! bootstrap 8.x-3.40 — Minor update available for theme bootstrap (8.x-3.40). menu_link_attributes 8.x-1.7 — Minor update available for module menu_link_attributes (8.x-1.7). eca 3.1.1 — Minor update available for module eca (3.1.1). layout_paragraphs 2.1.3 — Minor update available for module layout_paragraphs (2.1.3). ai 1.3.3 — Minor update available for module ai (1.3.3). ai 1.2.14 — Minor update available for module ai (1.2.14). node_revision_delete 2.0.3 — Minor update available for module node_revision_delete (2.0.3). moderated_content_bulk_publish 2.0.52 — Minor update available for module moderated_content_bulk_publish (2.0.52). klaro 3.0.10 — Minor update available for module klaro (3.0.10). klaro 3.0.9 — Minor update available for module klaro (3.0.9). layout_paragraphs 2.1.2 — Minor update available for module layout_paragraphs (2.1.2). geofield_map 11.1.8 — Minor update available for module geofield_map (11.1.8).
← All modules

background_image

801 sites Security covered
View on drupal.org

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
8 months ago
Release cadence
—
Stability
0% stable

Releases

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