PR Layout

PR Section Layout

You can define how a PR section displays items in its table by setting options for the available columns. You can define a column’s width, whether it grows to fill available space, and whether the column should be visible at all.

Note that if the length of a column’s text exceeds the defined column width, the view truncates the column’s text to two characters shorter than the column’s width. For example, if the width is 6, gh-dash displays as gh-d.

Column headings have their color defined by the theme.colors.text.primary setting.

By default, PR views display the following columns in the order they’re listed:

1. updatedAt with a width of 7 columns.
2. state with a width of 3 columns.
3. repo with a width of 15 columns.
4. title, set to grow to fill available space.
5. author with a width of 10 columns.
6. reviewStatus with a width of 3 columns.
7. ci with a width of 3 columns.
8. lines with a width of 16 columns.

Watch out!

Even though the state, title, comments, and reactions settings aren’t explicitly defined in your configuration file, they’re added to the table unless you set their hidden option to false.

updatedAt:
  width: 7
repo:
  width: 15
title:
  grow: true
author:
  width: 15
assignees:
  width: 20
  hidden: true
base:
  width: 15
  hidden: true
lines:
  width: 16

PR Updated At Column

Property	Type	Default
updatedAt	yaml	width: 7

This column displays how recently the PR was updated. The entry shows the time elapsed since the last update, like 1h or 3d.

The heading for this column is

PR State Column

Property	Type	Default
state	yaml	width: 3

This column displays the PR’s state as one of the following icons:

• When a PR is open and ready for review, the icon is and the color is #42a0fa.
• When a PR is in draft mode, the icon is and the color is set to the value of theme.colors.text.faint.
• When a PR is merged, the icon is and the color is #a371f7.
• When a PR is closed without merging, the icon is and the color is #c38080.

This heading for this column is

PR Repo Column

Property	Type	Default
repo	yaml	width: 15

This column displays the name of the repository the PR is filed in. The entry shows the name of the repository without the owner, like gh-dash for the https://github.com/dlvhdr/gh-dash repository.

The heading for this column is

PR Title Column

Property	Type	Default
title	yaml	width: 15 grow: true

This column displays the PR’s number followed by its title. This column is always displayed unless you set hidden to false. By default, it grows to fill the available space in the terminal after accounting for other column widths.

The heading for this column is Title.

The theme.colors.text.primary setting defines the issue number’s color.

PR Author Column

Property	Type	Default
author	yaml	width: 15

This column displays the username for the person who created the PR.

The heading for this column is Author.

PR Author Role Icon

Property	Type	Default
authorIcon	yaml	width: 3

This setting affects display of the role icon for the person who created the PR.

PR Assignees Column

Property	Type	Default
assignees	yaml	width: 20 hidden: true

This column displays the usernames for the people assigned to the PR.

The heading for this column is Assignees.

PR Base Column

Property	Type	Default
base	yaml	width: 15 hidden: true

This column displays the base branch the PR is targeting, like main.

The heading for this column is Base.

PR Review Status Column

Property	Type	Default
reviewStatus	yaml	width: 3

This column displays the review status of a PR as an icon:

• When the PR hasn’t been reviewed, the icon is and the color is the value of theme.colors.text.faint.
• When the PR is approved, the icon is and the color is the value of theme.colors.text.primary.
• When the PR has requested changes, the icon is and the color is the value of theme.colors.text.warning.

The heading for this column is .

PR Continuous Integration Column

Property	Type	Default
ci	yaml	width: 3

This column displays the CI status of a PR as an icon:

• When the checks haven’t finished running, the icon is and the color is the value of theme.colors.text.faint.
• When the checks have all passed, the icon is and the color is the value of [theme.colors.text.success].
• When at least one check failed, the icon is and the color is the value of theme.colors.text.warning.

The heading for this column is

PR Lines Column

Property	Type	Default
lines	yaml	width: 16

This column displays the line changes for a PR. The column represents the changes as <added> / -<removed>. For example, 66 / -46 indicates 66 lines added and 46 lines removed.

The heading for this column is .