Style Options is designed to provide themers and developers with a centralized means of managing styles across an entire website via simple YAML files. Style Options is similar to Layout Options, but includes an integration with Paragraphs and eventually other plugins (Blocks, etc.).
Style Options includes three style plugins currently:
- The CSS Class plugin, for attaching custom CSS classes to components.
- The Background Color plugin, for attaching background colors to components.
- The Background Image plugin, for attaching background images to components.
Part of the Mercury Editor™ ecosystem

Style Options is a component of the Mercury Editor ecosystem. Mercury Editor empowers content editors to create custom layouts in seconds with an easy-to-use Drupal page builder.
Getting Started
Style Options is a developer module and does not provide an admin interface. Once the module is installed, developers can create configuration files in modules or themes, named [module name].style_options.yml or [theme name].style_options.yml, in the root folder of either a module or theme, respectively. See examlpe.style_options.yml for an overview of possible configuration.
To use with layouts:
Your layouts will need to reference the provided layout plugin, or a custom class that inherits from the provided layout plugin.
To use with paragraph types:
Enable the "Style Options" paragraph behavior for each paragraph type where you want provided style options to appear.
This module is in early development, and APIs may change at any time. Questions or feedback? Open an issue in the issue queue!
Project information
- Ecosystem: Layout Paragraphs, Mercury Editor
2,646 sites report using this module
- Created by justin2pin on , updated
Stable releases for this project are covered by the security advisory policy.
Look for the shield icon below.


