missing info about specifying multiple properties #42539
Description
MDN URL
What specific section or headline is this issue about?
Using multiple backgrounds
What information was incorrect, unhelpful, or incomplete?
I looked here and at the specific background-* properties, but none convey what the spec says about what happens with multiple backgrounds and single properties:
From https://drafts.csswg.org/css-backgrounds-4/#layering
If a property doesn’t have enough comma-separated values to match the number of layers, the UA must calculate its used value by repeating the list of values until there are enough.
This is important, because each of the background properties has a default value, which it gets when not specified in the shorthand background property.
What did you expect to see?
I thought I would see examples that show what happens when you leave off properties when using multiple backgrounds, or examples on the individual property pages of using a list after specifying the majority with the background property.
Do you have any supporting links, references, or citations?
No response
Do you have anything more you want to share?
Some of the background-* property pages don't demonstrate all the scenarios, such as the background-position initial value is 0 0, but specifying only one number defaults the second one to 50%.
Also, the background-position example uses the background property instead of the background-position property, so the example is not aligned with the explanation.
MDN metadata
Page report details
- Folder:
en-us/web/css/guides/backgrounds_and_borders/using_multiple_backgrounds - MDN URL: https://developer.mozilla.org/en-US/docs/Web/CSS/Guides/Backgrounds_and_borders/Using_multiple_backgrounds
- GitHub URL: https://github.com/mdn/content/blob/main/files/en-us/web/css/guides/backgrounds_and_borders/using_multiple_backgrounds/index.md
- Last commit: ca5d9f9
- Document last modified: 2025-11-20T07:05:04.000Z