caption-side

The caption-side CSS property puts the content of a table's <caption> on the specified side. The values are relative to the writing-mode of the table.

Syntax

/* Directional values */
caption-side: top;
caption-side: bottom;

/* Logical values */
caption-side: block-start;
caption-side: block-end;
caption-side: inline-start;
caption-side: inline-end;

/* Global values */
caption-side: inherit;
caption-side: initial;
caption-side: unset;

The caption-side property is specified as one of the keyword values listed below.

Values

top
The caption box should be positioned above the table.
bottom
The caption box should be positioned below the table.
block-start
The caption box should be positioned at the block start edge of the table.
block-end
The caption box should be positioned at the block end edge of the table.
inline-start
The caption box should be positioned at the inline start edge of the table.
inline-end
The caption box should be positioned at the inline end edge of the table.

Formal definition

Initial valuetop
Applies totable-caption elements
Inheritedyes
Computed valueas specified
Animation typediscrete

Formal syntax

top | bottom | block-start | block-end | inline-start | inline-end

Examples

Setting captions above and below

HTML

<table class="top">
  <caption>Caption ABOVE the table</caption>
  <tr>
    <td>Some data</td>
    <td>Some more data</td>
  </tr>
</table>

<br>

<table class="bottom">
  <caption>Caption BELOW the table</caption>
  <tr>
    <td>Some data</td>
    <td>Some more data</td>
  </tr>
</table>

CSS

.top caption {
  caption-side: top;
}

.bottom caption {
  caption-side: bottom;
}

table {
  border: 1px solid red;
}

td {
  border: 1px solid blue;
}

Result

Specifications

Specification Status Comment
CSS Logical Properties and Values Level 1
The definition of 'caption-side' in that specification.
Editor's Draft Defines the top and bottom values as relative to the writing-mode value.
CSS Level 2 (Revision 1)
The definition of 'caption-side' in that specification.
Recommendation Initial definition.

Browser compatibility

BCD tables only load in the browser