Skip to the main content

The background colours that Webal Layouts offers for a section or a row are the standard colours of Cassiopeia. No setting changes them, not in Webal Layouts, not in Webal Blocks and not in Cassiopeia. To give a band your brand colour with settings only, let a Webal Blocks module paint the band, as this page shows.

The colour choices

A section or a row has a setting called Background. Each choice prints one standard class on that band. Nothing else is printed: no style sheet and no style rules inside the page. Only a background picture adds one small style rule, as Background pictures and shades explains.

The Background choices and the class that each one prints
ChoiceClass printedText colour
Primarytext-bg-primaryWhite
Secondarytext-bg-secondaryWhite
Successtext-bg-successWhite
Dangertext-bg-dangerWhite
Warningtext-bg-warningWhite
Infotext-bg-infoWhite
Darktext-bg-darkWhite
Lightbg-lightThe page text colour
Pagebg-bodyThe page text colour
Soft greybg-body-secondaryThe page text colour
Faintbg-body-tertiaryThe page text colour

The editor marks the first seven as strong colour, and warns that links on them can be hard to read. In Cassiopeia, the colour Primary is a deep navy blue.

Do the Webal Blocks colours change these?

No. We read the code of both products and of Cassiopeia to check this.

  • In the Webal Blocks Options, the Appearance tab has Accent colour, Link colour, Link hover colour and Button colour. They colour the Webal Blocks modules, the links in them and the main buttons of the site. They do not change the Background choices of a section or a row.
  • Cassiopeia's own Colour setting, Standard or Alternative, changes Cassiopeia's accent and link colours. It does not change the Background choices either.

So a section with the Background Primary stays deep navy, whatever colours you choose in those settings.

In dark colours, the four soft colours, Light, Page, Soft grey and Faint, turn dark with the page while the Dark styles for Cassiopeia of Webal Blocks are on. The seven strong colours stay as they are. See Dark styles and colour modes.

Your brand colour in a band, with settings only

A Webal Blocks module with a Background group can paint its own band. Its colour Primary follows the accent colour that you choose in the Webal Blocks Options, in light and in dark colours. So the band takes your brand colour, and the section around it stays without a background.

  1. Open Components, then Webal Blocks, then Dashboard, and press Options. On the Appearance tab, set Use the template's colours to No and choose your Accent colour. If the lighter shade that is worked out for dark colours is not right, choose an Accent colour in dark mode as well. Press Save & Close.
  2. Open the layout in the builder and click the section. Set its Background to None. Set Space above and Space below to None as well, because the section's own space shows in the page colour above and below the band.
  3. Press Publish.
  4. Open the Webal Blocks module that sits in the section's position. Use a module that has the Background group on its Layout tab, such as Webal Call to Action, Webal Text, Webal Features or Webal Cards.
  5. On the Layout tab, set Background colour to Primary. For a colour that is not your accent, choose My own colour and fill in Your own background colour. That colour stays the same in light and dark colours.
  6. Leave Text colour on Inherit, so that Webal Blocks picks text that can be read on the colour.
  7. To let the colour run from one edge of the screen to the other, set Width of the block to Full width, edge to edge, and keep Width of the content on Container. On the Advanced tab, set Module Style to None.
  8. Press Save & Close, and look at the page in light and dark colours.

Sections that hold other modules

For a section whose modules are not Webal Blocks modules with a Background group, the colour comes only from the section's own Background, and those choices follow the template's colours. Webal Layouts has no setting for a colour of your own on a section or a row yet.

Cassiopeia lets you add your own CSS in a file called user.css, if you know CSS. Webal Layouts never writes that file, and the package does not contain one. In our test, an update left an existing user.css in the child theme unchanged.

Check the contrast

Look at the result in light and in dark colours whenever you change a colour.

  • The standard strong colours are already close to the limit for white text. Standard Secondary gives 4.67 to 1, Success 4.59 to 1 and Warning 4.64 to 1.
  • Cassiopeia's blue links are hard to read on a strong colour. That is why the editor warns about links on the first seven choices.
  • In dark colours the strong colours stay as they are, so a very dark colour on a dark page is hard to tell apart from the page.
  • On a module's band, the Text colour setting refuses a choice that is hard to read, and Inherit picks one that can be read.

For specialists. We aim for a contrast of at least 4.5 to 1 for ordinary text, the usual target of WCAG 2.2 level AA. We measured computed colours in Chrome on 5 November 2026, in light colours and in dark colours. The dark colours were made by the dark styles of Webal Blocks for Cassiopeia, on a test site with Joomla 6.2.0. We did not use a screen reader, and we did not test other browsers.

Background pictures and shades

A section can also have a background picture, chosen with Choose a picture in its settings, from the pictures in the site's images folder. Upload the picture in Joomla's Media manager first. See Sections with rows and pictures.

Words over a photograph are often hard to read, because a photograph has light and dark parts. So the setting Shade over the picture lays a tint over it.

The shades and the colour of the words
ShadeTint over the pictureClass printedWords
Dark60 % blacktext-bg-darkWhite
Light80 % whitetext-bg-lightDark words, also when a dark colour mode is on
NoneNo tintThe section's own Background, if anyAs the Background sets them
  • With Dark, even a pure white picture becomes a mid grey under the tint, and white words on it keep a contrast of about 5.7 to 1, above the 4.5 to 1 that ordinary text needs.
  • With Light, even a pure black picture becomes a pale grey, and Cassiopeia's dark words stay far above 4.5 to 1.
  • The class of the shade also gives the section its colour while the picture loads, so the words are readable before the picture arrives. With a shade, the section's own Background colour is not used.
  • A picture with the shade None gets a warning in Checks. Keep None only when nothing in the section is text.

The tint is fixed. Webal Layouts does not measure the contrast of your pictures, so look at each one with its words, and look at a Light shade in dark colours too, if your site has a colour switch.

For developers. The picture is printed as a class wbll-bg- followed by the section's handle, with one scoped CSS rule for that class that Webal Layouts adds through Joomla's Web Asset Manager, so a site's Content Security Policy nonce applies to it. It is never a style attribute. The rule makes the picture cover the section, centred, with the shade as a gradient layer over it.

How we checked it

On 19 November 2026 we read the style sheet of Cassiopeia on Joomla 6.2.0, Cassiopeia's two colour files, and the colours that the Webal Blocks Options print. Cassiopeia paints each Background choice from a fixed colour of its own toolkit. Its Colour setting and the Webal Blocks Options set other colours, so they leave these choices as they are. The contrast figures above were measured in Chrome on 5 November 2026. The steps with a Webal Blocks module have not been run as one test of their own, so look at the result on your site. We have not checked any of this on Joomla 5.4.

Try it

  1. On a test site, choose your Accent colour in the Webal Blocks Options, as in the first step above.
  2. In the builder, give a section the Background None, with Space above and Space below set to None. Press Publish.
  3. Put a Webal Call to Action module in the section's position, with Background colour set to Primary and Width of the block set to Full width, edge to edge.
  4. Open a page that uses the layout. The band has your accent colour from edge to edge.
  5. Switch the colour mode to dark, if your site has the colour switch. The band takes the dark shade of your accent colour.

Other ways to reach us

Ask the community