# Info section

Add help text and info boxes to the Panel to help your editors

****

- Source: <https://github.com/getkirby/kirby/tree/5.5.3/config/sections/info.php>

****

The info section is perfect for any kind of static text that you want to place in a <abbr title="The Panel is Kirby's fast and powerful web interface to manage your website in the browser. The Panel is highly customizable in many ways for different project needs."><a href="https://getkirby.com/docs/glossary/#panel">Panel</a></abbr> layout. It can be used for general info, help, warnings and other guides for your editors.

<figure class="image"><a data-lightbox href="https://assets.getkirby.com/media/pages/docs/reference/panel/sections/info/cd133a10e3-1717846665/info-section-default.png?width=1416&amp;height=328&amp;enlarge=0"><img alt="" class="rounded" height="214" loading="lazy" sizes="auto" src="https://assets.getkirby.com/media/pages/docs/reference/panel/sections/info/cd133a10e3-1717846665/info-section-default.png?width=924&amp;height=214&amp;enlarge=0" srcset="https://assets.getkirby.com/media/pages/docs/reference/panel/sections/info/cd133a10e3-1717846665/info-section-default.png?width=462&amp;height=107&amp;enlarge=0 462w, https://assets.getkirby.com/media/pages/docs/reference/panel/sections/info/cd133a10e3-1717846665/info-section-default.png?width=690&amp;height=160&amp;enlarge=0 690w, https://assets.getkirby.com/media/pages/docs/reference/panel/sections/info/cd133a10e3-1717846665/info-section-default.png?width=924&amp;height=214&amp;enlarge=0 924w, https://assets.getkirby.com/media/pages/docs/reference/panel/sections/info/cd133a10e3-1717846665/info-section-default.png?width=1380&amp;height=320&amp;enlarge=0 1380w, https://assets.getkirby.com/media/pages/docs/reference/panel/sections/info/cd133a10e3-1717846665/info-section-default.png?width=1416&amp;height=328&amp;enlarge=0 1848w" width="924"></a></figure>

## Example

```yaml
title: Gallery

sections:
  info:
    type: info
    label: Info
    text: |
      Please double-check the licenses and sources
      of all images before you upload them to the gallery.
```

### Using KirbyText

In addition to markdown, you can use KirbyText in your info text, even including images:

```yaml
info:
  text: |
    Check out the &lpar;link: help text: help pages) for details
```

## Section shortcuts

For simple sections that are only used once per blueprint, you can use shortcuts. In its most basic form, an `info` section consists of the section type as name, and the `text` property with the information you want to show.

```yaml
sections:
  info:
    text: Some text
```

Keep in mind that the same section name can only be used once per blueprint.

## Info section vs. info field

The info section behaves pretty much like the <a href="https://getkirby.com/docs/reference/panel/fields/info">info field</a>. Why do we have both of them? Because both are useful. The info field can be placed in a field grid and is perfect to offer help within a form. The info section can be placed anywhere else, especially in layouts that don't need form fields.

## Section 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>
					headline				</td>
				<td><code class="type type-mixed">mixed</code></td>

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

								<td>The headline for the section. This can be a simple string or a template with additional info from the parent page.</td>
							</tr>
						<tr>
				<td>
					icon				</td>
				<td><code class="type type-string">string</code></td>

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

								<td></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 label for the section. This can be a simple string or a template with additional info from the parent page. Replaces the <code class="type">headline</code> prop.</td>
							</tr>
						<tr>
				<td>
					text				</td>
				<td><code class="type type-mixed">mixed</code></td>

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

								<td></td>
							</tr>
						<tr>
				<td>
					theme				</td>
				<td><code class="type type-string">string</code></td>

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

								<td></td>
							</tr>
					</tbody>
	</table>
</div>

## Label

The label will be displayed above the info section. You can pass a simple headline as a string or you can provide translations for multiple languages, if you have an international editing team.

### Single language

```yaml
label: This is some very important information
```

### Multiple languages
```yaml
headline:
  en: Attention
  de: Achtung
  es: Attencion
```

### Placeholders

You can inject information from the current page into the headline with template placeholders using our <a href="https://getkirby.com/docs/guide/blueprints/query-language">query language</a>.

```yaml
label: "{{ page.title }} Information"
```

## Text

The text can be a simple string, Markdown, KirbyText or HTML. Just like the headline, the text can also be translated. You can also use Kirby's query language to query text from some field or show some other information.

### Single language
```yaml
text: Info
```

### Multiple languages
```yaml
text:
  en: This is some very important information
  de: Das ist eine wichtige Mitteilung
```

### Multi-line text

If you want to write multi-line text with paragraphs, you have to use a special YAML syntax for it.

```yaml
text: |
  Dear Edith,

  this is some multi line text with paragraphs.

  Cheers,
  A. Dmin
```
### Text queries

```yaml
text: "{{ kirby.page('somepage').text()->kt() }}"
text: "{{ site.index.count }}"
text: "{{ site.index.images.count }}"
```

## Themes

By default, the info section is displayed as a blue info box. You can switch the theme with the `theme` option, to match the importance or meaning of the information.

The following themes are available:

- `info` (default)
- `positive`
- `negative`
- `notice`
- `warning`
- `passive`
- `text`
- `dark`
- `code`
- `empty`

### info

```yaml
title: Gallery

sections:
  info:
    type: info
    label: Info
    theme: info
    text: |
      Please double-check the licenses and sources
      of all images before you upload them to the gallery.
```

### negative

<figure class="image"><a data-lightbox href="https://assets.getkirby.com/media/pages/docs/reference/panel/sections/info/51427beb2a-1717846665/info-section-negative.png?width=1416&amp;height=364&amp;enlarge=0"><img alt="" class="rounded" height="238" loading="lazy" sizes="auto" src="https://assets.getkirby.com/media/pages/docs/reference/panel/sections/info/51427beb2a-1717846665/info-section-negative.png?width=924&amp;height=238&amp;enlarge=0" srcset="https://assets.getkirby.com/media/pages/docs/reference/panel/sections/info/51427beb2a-1717846665/info-section-negative.png?width=462&amp;height=119&amp;enlarge=0 462w, https://assets.getkirby.com/media/pages/docs/reference/panel/sections/info/51427beb2a-1717846665/info-section-negative.png?width=690&amp;height=177&amp;enlarge=0 690w, https://assets.getkirby.com/media/pages/docs/reference/panel/sections/info/51427beb2a-1717846665/info-section-negative.png?width=924&amp;height=238&amp;enlarge=0 924w, https://assets.getkirby.com/media/pages/docs/reference/panel/sections/info/51427beb2a-1717846665/info-section-negative.png?width=1380&amp;height=355&amp;enlarge=0 1380w, https://assets.getkirby.com/media/pages/docs/reference/panel/sections/info/51427beb2a-1717846665/info-section-negative.png?width=1416&amp;height=364&amp;enlarge=0 1848w" width="924"></a></figure>

```yaml
title: Gallery

sections:
  info:
    type: info
    label: Attention
    theme: negative
    text: |
      Please double-check the licenses and sources
      of all images before you upload them to the gallery.
```

### positive

<figure class="image"><a data-lightbox href="https://assets.getkirby.com/media/pages/docs/reference/panel/sections/info/e3821fca3a-1717846665/info-section-positive.png?width=1416&amp;height=364&amp;enlarge=0"><img alt="" class="rounded" height="238" loading="lazy" sizes="auto" src="https://assets.getkirby.com/media/pages/docs/reference/panel/sections/info/e3821fca3a-1717846665/info-section-positive.png?width=924&amp;height=238&amp;enlarge=0" srcset="https://assets.getkirby.com/media/pages/docs/reference/panel/sections/info/e3821fca3a-1717846665/info-section-positive.png?width=462&amp;height=119&amp;enlarge=0 462w, https://assets.getkirby.com/media/pages/docs/reference/panel/sections/info/e3821fca3a-1717846665/info-section-positive.png?width=690&amp;height=177&amp;enlarge=0 690w, https://assets.getkirby.com/media/pages/docs/reference/panel/sections/info/e3821fca3a-1717846665/info-section-positive.png?width=924&amp;height=238&amp;enlarge=0 924w, https://assets.getkirby.com/media/pages/docs/reference/panel/sections/info/e3821fca3a-1717846665/info-section-positive.png?width=1380&amp;height=355&amp;enlarge=0 1380w, https://assets.getkirby.com/media/pages/docs/reference/panel/sections/info/e3821fca3a-1717846665/info-section-positive.png?width=1416&amp;height=364&amp;enlarge=0 1848w" width="924"></a></figure>

```yaml
title: Gallery

sections:
  info:
    type: info
    label: Wohooww
    theme: positive
    text: |
      Just upload whatever you want. We get sued anyway.
```

### Disable theming

You can disable the infobox theme entirely to show neutral text.

```yaml
fields:
  info:
    type: info
    label: Info
    theme: none
    text: |
      This is a very neutral message
```

<h2 id="conditional-sections"><a href="#conditional-sections" tabindex="-1">Conditional sections</a></h2>
<p>Like <a href="https://getkirby.com/docs/guide/blueprints/fields#conditional-fields">conditional fields</a>, sections can be shown/hidden based on the value of a given field (i.e. if a toggle is checked, a select field is at a certain option, etc.).</p>
<p>The condition for displaying the section is set with the <code class="type">when</code> option. In the <code class="type">when</code> option you define a field name as the key and the required value of that field. In the following example, the each section type is shown based on a different value of the <code class="type">postType</code> field:</p>
<figure class="code">
<pre><code class="language-yaml">sections:
  content:
    type: fields
    fields:
      postType:
        type: select
        options:
          - Gallery
          - Image
          - Text
  gallery:
    type: files
    template: gallery-image
    layout: cards
    size: tiny
    when:
      postType: Gallery
  image:
    type: files
    template: single-image
    max: 1
    layout: cards
    when:
      postType: Image
  text:
    type: fields
    fields:
      text:
        type: textarea
      tags:
        type: tags
    when:
      postType: Text</code></pre>
</figure>