W3cubDocs

/SVG

<tspan>

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨July 2015⁩.

* Some parts of this feature may have varying levels of support.

The <tspan> SVG element defines a subtext within a <text> element or another <tspan> element. It allows for adjustment of the style and/or position of that subtext as needed.

Note: The <tspan> element does not wrap by default, to make this happen it needs to be styled with the white-space CSS property.

Usage context

Categories Text content element, Text content child element
Permitted content Character data and any number of the following elements, in any order:
Descriptive elements
<a>, <animate>, <discard>, <set>, <tspan>

Attributes

x

The x coordinate of the starting point of the text baseline, or the x coordinate of each individual glyph if a list of values is provided. Value type: List of (<length> | <percentage>); Default value: 0; Animatable: yes

y

The y coordinate of the starting point of the text baseline, or the y coordinate of each individual glyph if a list of values is provided. Value type: List of (<length> | <percentage>); Default value: 0; Animatable: yes

dx

Shifts the text position horizontally from a previous text element, or shifts the position of each individual glyph if a list of values is provided. Value type: List of (<length> | <percentage>); Default value: none; Animatable: yes

dy

Shifts the text position vertically from a previous text element, or shifts the position of each individual glyph if a list of values is provided. Value type: List of (<length> | <percentage>); Default value: none; Animatable: yes

rotate

Rotates orientation of each individual glyph. Can rotate glyphs individually. Value type: <list-of-number>; Default value: none; Animatable: yes

lengthAdjust

How the text is stretched or compressed to fit the width defined by the textLength attribute. Value type: spacing | spacingAndGlyphs; Default value: spacing; Animatable: yes

textLength

A width that the text should be scaled to fit. Value type: <length> | <percentage>; Default value: none; Animatable: yes

DOM Interface

This element implements the SVGTSpanElement interface.

Example

<svg viewBox="0 0 240 40" xmlns="http://www.w3.org/2000/svg">
  <style>
    text {
      font: italic 12px serif;
    }
    tspan {
      font: bold 10px sans-serif;
      fill: red;
    }
  </style>

  <text x="10" y="30" class="small">
    You are
    <tspan>not</tspan>
    a banana!
  </text>
</svg>

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet WebView Android WebView on iOS
tspan 1 12 1.5 9 3 18 4 14 2 1.0 3 2
dx 1 12 1.5 15 3 18 4 14 2 1.0 4.4 2
dy 1 12 1.5 15 3 18 4 14 2 1.0 4.4 2
fill 1 79 1.5 15 3 18 4 14 2 1.0 4.4 2
lengthAdjust 1 79 No 15 3 18 No 14 2 1.0 4.4 2
rotate 1 79 1.5 15 3 18 4 14 2 1.0 4.4 2
systemLanguage 1 12 12 9 3 18 14 14 2 1.0 3 2
textLength 1 12 No 15 3 18 No 14 2 1.0 4.4 2
x 1 12 1.5 15 3 18 4 14 2 1.0 4.4 2
y 1 12 1.5 15 3 18 4 14 2 1.0 4.4 2

See also

© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/tspan