﻿---
title: Banner settings in Kibana
description: 
url: https://www.elastic.co/elastic/docs-builder/docs/3174/reference/kibana/configuration-reference/banner-settings
products:
  - Kibana
applies_to:
  - Self-managed Elastic deployments: Generally available
---

# Banner settings in Kibana
Banners are disabled by default. You need to manually configure them in order to use the feature.
You can configure the `xpack.banners` settings in your `kibana.yml` file.

<note>
  Banners are a [subscription feature](https://www.elastic.co/subscriptions).
</note>


## All settings
<definitions>
  <definition term="xpack.banners.placement">
    <supported-on>Elastic Cloud Hosted: Generally available, Self-managed Elastic deployments: Generally available</supported-on>

Set to `top` to display a banner above the Elastic header.
Datatype: `enum`
Default: `disabled`
Options:
- `disabled`
- `top`
  </definition>
  <definition term="xpack.banners.textContent">
    <supported-on>Elastic Cloud Hosted: Generally available, Self-managed Elastic deployments: Generally available</supported-on>

The text to display inside the banner, either plain text or Markdown.
Datatype: `string`
  </definition>
  <definition term="xpack.banners.textColor">
    <supported-on>Elastic Cloud Hosted: Generally available, Self-managed Elastic deployments: Generally available</supported-on>

The color for the banner text.
Datatype: `string`
Default: `#8A6A0A`
  </definition>
  <definition term="xpack.banners.linkColor">
    <stack-availability>Elastic Stack: Generally available since 9.1</stack-availability>
    <supported-on>Elastic Cloud Hosted: Generally available, Self-managed Elastic deployments: Generally available</supported-on>

The color for the banner link text.
Datatype: `string`
Default: `#0B64DD`
  </definition>
  <definition term="xpack.banners.backgroundColor">
    <supported-on>Elastic Cloud Hosted: Generally available, Self-managed Elastic deployments: Generally available</supported-on>

The color of the banner background.
Datatype: `string`
Default: `#FFF9E8`
  </definition>
  <definition term="xpack.banners.disableSpaceBanners">
    <supported-on>Elastic Cloud Hosted: Generally available, Self-managed Elastic deployments: Generally available</supported-on>

If true, per-space banner overrides will be disabled.
Datatype: `bool`
Default: `false`
  </definition>
</definitions>