# Headline

Creates a headline to group fields

****

- Read more: <https://getkirby.com/docs/guide/blueprints/fields>
- Source: <https://github.com/getkirby/kirby/tree/5.5.3/config/fields/headline.php>

****

The headline field helps to group larger sets of fields. It creates a headline with additional white-space and a prepended index number.

<figure class="image"><a data-lightbox href="https://assets.getkirby.com/media/pages/docs/reference/panel/fields/headline/c1023014ac-1717846665/headline.png?width=1416&amp;height=248&amp;enlarge=0"><img alt="" class="rounded" height="162" loading="lazy" sizes="auto" src="https://assets.getkirby.com/media/pages/docs/reference/panel/fields/headline/c1023014ac-1717846665/headline.png?width=924&amp;height=162&amp;enlarge=0" srcset="https://assets.getkirby.com/media/pages/docs/reference/panel/fields/headline/c1023014ac-1717846665/headline.png?width=462&amp;height=81&amp;enlarge=0 462w, https://assets.getkirby.com/media/pages/docs/reference/panel/fields/headline/c1023014ac-1717846665/headline.png?width=690&amp;height=121&amp;enlarge=0 690w, https://assets.getkirby.com/media/pages/docs/reference/panel/fields/headline/c1023014ac-1717846665/headline.png?width=924&amp;height=162&amp;enlarge=0 924w, https://assets.getkirby.com/media/pages/docs/reference/panel/fields/headline/c1023014ac-1717846665/headline.png?width=1380&amp;height=242&amp;enlarge=0 1380w, https://assets.getkirby.com/media/pages/docs/reference/panel/fields/headline/c1023014ac-1717846665/headline.png?width=1416&amp;height=248&amp;enlarge=0 1848w" width="924"></a></figure>

## Example

```yaml
fields:
  pageSettings:
    label: Page Settings
    type: headline
  type:
    label: Page type
    type: text
  state:
    label: Draft
    type: toggle
  content:
    label: Content
    type: headline
  text:
    label: Text
    type: textarea
```

## Field properties



<div class="table">
	<table class="parameters">
		<thead>
			<tr>
				<th>Name</th>
				<th>Type</th>
				<th>Default</th>

								<th>Description</th>
							</tr>
		</thead>
		<tbody>
						<tr>
				<td>
					help				</td>
				<td><code class="type type-mixed">mixed</code></td>

				<td data-label="Default:">
															<code>null</code>
									</td>

								<td>Optional help text below the field</td>
							</tr>
						<tr>
				<td>
					label				</td>
				<td><code class="type type-mixed">mixed</code></td>

				<td data-label="Default:">
															<code>null</code>
									</td>

								<td>The field label can be set as string or associative array with translations</td>
							</tr>
						<tr>
				<td>
					when				</td>
				<td><code class="type type-mixed">mixed</code></td>

				<td data-label="Default:">
															<code>null</code>
									</td>

								<td>Conditions when the field will be shown (since 3.1.0)</td>
							</tr>
						<tr>
				<td>
					width				</td>
				<td><code class="type type-string">string</code></td>

				<td data-label="Default:">
															<code>'1/1'</code>
									</td>

								<td>The width of the field in the field grid, e.g. <code class="type">1/1</code>, <code class="type">1/2</code>, <code class="type">1/3</code>, <code class="type">1/4</code>, <code class="type">2/3</code>, <code class="type">3/4</code></td>
							</tr>
					</tbody>
	</table>
</div>