Block

Let's take a closer look at what defines a block.

json

{
  "$schema": "https://raw.githubusercontent.com/JanDeDobbeleer/oh-my-posh/main/themes/schema.json",
  ...
  "blocks": [
    {
      "type": "prompt",
      "alignment": "left",
      "segments": [
        ...
      ]
    }
  ]
}

yaml

# yaml-language-server: $schema=https://raw.githubusercontent.com/JanDeDobbeleer/oh-my-posh/main/themes/schema.json
---
blocks:
  - type: prompt
    alignment: left
    segments: [...]

toml

"$schema" = "https://raw.githubusercontent.com/JanDeDobbeleer/oh-my-posh/main/themes/schema.json"

[[blocks]]
type = "prompt"
alignment = "left"
segments = [
  ...
]

Properties

Name	Type
type	string
newline	boolean
alignment	string
filler	string
overflow	string
segments	array

Type

Tells the engine what to do with the block. There are two options:

• prompt renders one or more segments
• rprompt renders one or more segments aligned to the right of the cursor. Only one rprompt block is permitted. Supported on zsh, bash, PowerShell, cmd and fish.

Newline

Start the block on a new line - defaults to false.

Alignment

• left
• right

Tell the engine if the block should be left or right-aligned.

Filler

When you want to join a right and left aligned block with a repeated set of characters, add the character(s) to be repeated to this property. Add this property to the right aligned block. This supports the use of color overrides.

"alignment": "right",
"filler": "."

Overflow

• break
• hide

When the right aligned block is so long it will overflow the left aligned block, the engine will either break the block or hide it based on the setting. By default it is printed as is on the same line.

Segments

Array of one or more segments.