`word-spacing` CSS property
The word-spacing CSS property sets the spacing between words and between tags.
The word-spacing CSS property sets the spacing between words and between tags.
CSS Demo: word-spacing
```css interactive-example-choice word-spacing: normal;
```css interactive-example-choice
word-spacing: 1rem;
```css interactive-example-choice word-spacing: 4px;
```css interactive-example-choice
word-spacing: 50%;
```css interactive-example-choice word-spacing: -0.4ch;
```html interactive-example
<section id="default-example">
<p id="example-element">
As much mud in the streets as if the waters had but newly retired from the
face of the earth, and it would not be wonderful to meet a Megalosaurus,
forty feet long or so, waddling like an elephantine lizard up Holborn Hill.
</p>
</section>
```css interactive-example @font-face { src: url("/shared-assets/fonts/variable-fonts/AmstelvarAlpha-VF.woff2"); font-family: "Amstelvar"; font-style: normal; }
section { font-size: 1.2em; font-family: "Amstelvar", serif; }
## Syntax
```css
/* Keyword value */
word-spacing: normal;
/* <length> values */
word-spacing: 3px;
word-spacing: 0.3em;
word-spacing: 65%;
word-spacing: -1ex;
/* Global values */
word-spacing: inherit;
word-spacing: initial;
word-spacing: revert;
word-spacing: revert-layer;
word-spacing: unset;
Values
This property is specified as the keyword normal or a <length-percentage>:
normal- : The normal inter-word spacing, as defined by the current font and/or the browser.
- length-percentage
- : Specifies extra spacing in addition to the intrinsic inter-word spacing defined by the font. Percentage values are calculated relative to the font-size of the text.
Accessibility
A large positive or negative word-spacing value will make the sentences the styling is applied to unreadable. For text styled with a very large positive value, the words will be so far apart that it will no longer appear to be a sentence. For text styled with a large negative value, the words can overlap each other to the point where the beginning and end of each word is unrecognizable.
Legible word-spacing must be determined on a case-by-case basis, as different font families have different character widths. There is no one value that can ensure all font families automatically maintain their legibility.
- MDN Understanding WCAG, Guideline 1.4 explanations
- Understanding Success Criterion 1.4.8 | W3C Understanding WCAG 2.0
Formal definition
Formal syntax
Examples
Basic usage
This example demonstrates basic usage of word-spacing.
HTML
Our HTML contains two paragraphs of text:
```html live-sample___basic-usage
Lorem ipsum dolor sit amet.
Lorem ipsum dolor sit amet.
#### CSS
Our CSS applies a different `word-spacing` to each paragraph:
```css live-sample___basic-usage
#mozdiv1 {
word-spacing: 15px;
}
#mozdiv2 {
word-spacing: 5em;
}
Result
The example renders like so:
100%
Comparing word-spacing set with length and percentage
This example demonstrates that percentage word-spacing values are useful for responsive text sizing.
The code displays several paragraphs that have the same word-spacing set on text with increasing font size. We provide functionality to switch between a length and a percentage word-spacing value, so that you can observe the responsive qualities of using a percentage value.
HTML
The HTML contains several p elements containing text content, and an <input type="checkbox"> that we'll use to toggle between a length word-spacing and a percentage word-spacing value.
```html live-sample___percentage-versus-length
X-small font-size (0.8em)
Small font-size (1.3em)
Medium font-size (2em)
Large font-size (3em)
X-Large (3.5em)
#### CSS
Our CSS starts by applying increasing font-size values to each successive paragraph:
```css hidden live-sample___percentage-versus-length
html {
font-family: "Arial", sans-serif;
}
```css live-sample___percentage-versus-length .x-small { font-size: 0.8em; }
.small { font-size: 1.3em; }
.medium { font-size: 2em; }
.large { font-size: 3em; }
.x-large { font-size: 3.5em; }
We apply a `word-spacing` value of `10px` to all paragraphs by default. When the checkbox is checked, however, we change the `word-spacing` value to `15%`:
```css live-sample___percentage-versus-length
p {
word-spacing: 10px;
}
p:has(~ form > input:checked) {
word-spacing: 15%;
}
Result
The rendered result looks like this:
100%
First, note how the initial length letter spacing value looks OK when applied to the larger font sizes, but it doesn't look good on the smaller font sizes. Now toggle the checkbox, and note how the percentage letter spacing looks appropriate on all lines, as it scales with the font size.
Specifications
Browser compatibility
See also
- letter-spacing
- SVG word-spacing attribute