Apply Column Styles - Nextedy Documentation

Apply a Predefined Header Style

Powersheet includes 20 built-in styles you can apply directly to any column header. Add the header property with a style reference inside your column definition:

columns:
  description:
    title: "Foreseeable Sequence of Events"
    width: 140
    header:
      style: lightpurple

This sets the header text color and background according to the predefined lightpurple style.

Predefined Styles Reference

Style Name	Text Color	Background Color	Other
`none`	—	—	—
`boldTitle`	—	—	fontWeight: 600
`unsupported`	grey800	grey200	textDecoration: line-through
`readOnly`	—	—	Read-only visual indicator
`darkgrey`	grey700	grey200	—
`grey`	grey700	grey100	—
`darkred`	red700	red200	—
`red`	red700	red100	—
`darkorange`	orange700	orange200	—
`orange`	orange700	orange100	—
`darkgreen`	green700	green200	—
`green`	green700	green100	—
`lightgreen`	green700	primaryalt100	—
`darkblue`	blue700	blue200	—
`blue`	blue700	blue100	—
`lightblue`	blue700	teal100	—
`darkteal`	teal700	teal200	—
`teal`	teal700	teal100	—
`darkpurple`	purple700	purple200	—
`purple`	purple700	purple100	—
`lightpurple`	purple700	primary100	—

Use color families to visually group related columns: risks in red, controls in blue, requirements in purple, verification in green.

Define a Custom Style

To create your own style, add a definition in the styles section and reference it by name:

styles:
  warningHeader:
    backgroundColor: 'orange200'
    color: 'orange700'

columns:
  outlineNumber:
    title: "#"
    width: 80
    header:
      style: warningHeader

Custom styles are merged on top of the built-in defaults, so you can override any predefined style name with your own definition.

Apply Styles to Column Groups

Use columnGroups to apply consistent styling across a set of related columns. Each group supports three style properties:

columnGroups:
  epic:
    groupName: Epics
    groupStyle: darkgreen
    headerStyle: green
    collapseTo: title

columns:
  title:
    title: Title
    width: 200
    columnGroup: epic

Property	Description
`groupName`	Display name shown in the group header row (required)
`groupStyle`	Style applied to the group header band (optional). Predefined name or custom style. Defaults to white.
`headerStyle`	Style applied to all sub-column headers in the group (optional) — can be overridden per column via `header.style`. Defaults to white.
`collapseTo`	Binding path of the column shown when the group is collapsed (optional)

A column-level header.style takes priority over the group-level headerStyle. Use group styles for defaults and column styles for exceptions.

Color Tokens

Powersheet color tokens use a naming pattern of {color}{level} where levels range from 100 (lightest) to 700 (darkest). Available color families:

Use these tokens in custom style definitions:

styles:
  customHighlight:
    backgroundColor: 'red100'
    color: 'red700'

For the full list of color tokens and their levels, see the Styles reference.

Use YAML Anchors for Reuse

Define a header style once as a YAML anchor and reuse it across columns:

columns:
  systemRequirements.systemRequirement.title:
    title: System Requirement
    header: &blueHeader
      style: blue
  systemRequirements.systemRequirement.severity:
    title: Severity
    header: *blueHeader

Use Custom Styles in Formatters

Custom styles defined in the styles section can also be referenced by conditional formatters for cell-level styling:

styles:
  readOnlyStyle:
    backgroundColor: 'grey100'
  criticalHeader:
    color: 'red700'
    backgroundColor: 'red200'
    fontWeight: 600

formatters:
  readonly:
    - expression: 'true'
      style: readOnlyStyle

Use consistent colors across your sheet to group related columns visually: for example, red for risks, blue for requirements, green for controls, and purple for references.

Verify

After saving the sheet configuration, reload the powersheet document. You should now see styled column headers with the colors you specified, and any column group headers displaying their configured groupStyle. Verify that:

Individual column headers show the correct style
Group headers span the correct columns with the specified groupStyle
The collapseTo toggle works if configured (click the collapse button in the group header)

​Apply a Predefined Header Style

​Predefined Styles Reference

​Define a Custom Style

​Apply Styles to Column Groups

​Color Tokens

​Use YAML Anchors for Reuse

​Use Custom Styles in Formatters

​Verify

​See also

Apply a Predefined Header Style

Predefined Styles Reference

Define a Custom Style

Apply Styles to Column Groups

Color Tokens

Use YAML Anchors for Reuse

Use Custom Styles in Formatters

Verify

See also