Skip to content

cell_widths = {}

Since: Nightly Builds Only

The functionality described in this section requires a nightly build of wezterm. You can obtain a nightly build by following the instructions from the Download section.

The character width recommended by the Unicode standard is occasionally inconsistent and may not align with linguistic tradition.

  • circled numbers width: ⓪①..⑳㉑
  • lowercase Roman numerals width: ⅹⅺⅻ
  • Nerd Font (Private Use Area) character width
  • ambiguous character width for CJK text
  • square emojis defined as EAW=Neutral

The cell_widths configuration parameter allows users to override the default character width. This setting takes priority over the treat_east_asian_ambiguous_width_as_wide setting.

Nerd Font has square glyphs and is an example of half advance width. Below is a configuration example that treats these character widths as full-width:

config.cell_widths = {
  { first = 0xe000, last = 0xf8ff, width = 2 },
  { first = 0xf0000, last = 0xf1fff, width = 2 },
}

Note that changing this setting may have consequences for layout in text UI applications if their expectation of width differs from your choice of configuration.

For example, Vim has a built-in function setcellwidths(), and shells like Bash or Zsh determine character width based on the glibc locale.

See also: treat_east_asian_ambiguous_width_as_wide