= Sidebar Category Keys
:description: Reference list of the available sidebar category keys and their value types.
:navtitle: Sidebar
:source-language: yaml

[#sidebar]
== sidebar

The keys in the `sidebar` category control the arrangement and style of sidebar blocks.

[cols="3,4,5a"]
|===
|Key |Value Type |Example

|background-color
|xref:color.adoc[Color] +
(default: `'EEEEEE'`)
|[source]
sidebar:
  background-color: #121212

|border-color
|xref:blocks.adoc#border-color[Color] +
(default: _not set_)
|[source]
sidebar:
  border-color: #FFFFFF

|border-radius
|xref:blocks.adoc#radius[Measurement] +
(default: _not set_)
|[source]
sidebar:
  border-radius: 4

|border-style
|xref:blocks.adoc#border-style[Border style] +
(default: `solid`)
|[source]
sidebar:
  border-style: dashed

|border-width
|xref:blocks.adoc#border-width[Measurement] {vbar} xref:blocks.adoc#border-width[Measurement[\]] +
(default: _not set_)
|[source]
sidebar:
  border-width: 0.5

|font-color
|xref:color.adoc[Color] +
(default: _inherit_)
|[source]
sidebar:
  font-color: #262626

|font-family
|xref:font-support.adoc[Font family name] +
(default: _inherit_)
|[source]
sidebar:
  font-family: M+ 1p

|font-kerning
|`none` {vbar} `normal` +
(default: _inherit_)
|[source]
sidebar:
  font-kerning: none

|font-size
|xref:language.adoc#values[Number] +
(default: _inherit_)
|[source]
sidebar:
  font-size: 13

|font-style
|xref:text.adoc#font-style[Font style] +
(default: _inherit_)
|[source]
sidebar:
  font-style: italic

|padding
|xref:blocks.adoc#padding[Measurement] {vbar} xref:blocks.adoc#padding[Measurement[\]] +
(default: `12`)
|[source]
sidebar:
  padding: [12, 15]

|text-transform
|xref:text.adoc#transform[Text transform] +
(default: _inherit_)
|[source]
sidebar:
  text-transform: none
|===

[#title]
== sidebar-title

The keys in the `sidebar-title` category control the arrangement and style of sidebar block titles.

[cols="3,4,5a"]
|===
|Key |Value Type |Example

|font-color
|xref:color.adoc[Color] +
(default: _inherit_)
|[source]
sidebar:
  title:
    font-color: #333333

|font-family
|xref:font-support.adoc[Font family name] +
(default: _inherit_)
|[source]
sidebar:
  title:
    font-family: Noto Serif

|font-kerning
|`none` {vbar} `normal` +
(default: _inherit_)
|[source]
sidebar:
  title:
    font-kerning: none

|font-size
|xref:language.adoc#values[Number] +
(default: _inherit_)
|[source]
sidebar:
  title:
    font-size: 13

|font-style
|xref:text.adoc#font-style[Font style] +
(default: `bold`)
|[source]
sidebar:
  title:
    font-style: bold_italic

|text-align
|xref:text.adoc#text-align[Text alignment] +
(default: `center`)
|[source]
sidebar:
  title:
    text-align: left

|text-transform
|xref:text.adoc#transform[Text transform] +
(default: _inherit_)
|[source]
sidebar:
  title:
    text-transform: smallcaps
|===
