glanceapp/glance · error

split columns inside of groups are not supported

Error message

split columns inside of groups are not supported

What it means

Thrown by the group widget's initialize() when one of its direct children has type split-column. Split columns implement their own internal column layout and are incompatible with the group container's flattened rendering, so the combination is rejected at config-parse time.

Source

Thrown at internal/glance/widget-group.go:27

var groupWidgetTemplate = mustParseTemplate("group.html", "widget-base.html")

type groupWidget struct {
	widgetBase          `yaml:",inline"`
	containerWidgetBase `yaml:",inline"`
}

func (widget *groupWidget) initialize() error {
	widget.withError(nil)
	widget.HideHeader = true

	for i := range widget.Widgets {
		widget.Widgets[i].setHideHeader(true)

		if widget.Widgets[i].GetType() == "group" {
			return errors.New("nested groups are not supported")
		} else if widget.Widgets[i].GetType() == "split-column" {
			return errors.New("split columns inside of groups are not supported")
		}
	}

	if err := widget.containerWidgetBase._initializeWidgets(); err != nil {
		return err
	}

	return nil
}

func (widget *groupWidget) update(ctx context.Context) {
	widget.containerWidgetBase._update(ctx)
}

func (widget *groupWidget) setProviders(providers *widgetProviders) {
	widget.containerWidgetBase._setProviders(providers)
}

View on GitHub (pinned to 91324e8de7)

Solutions

  1. Move the split-column widget to the page's top level, outside the group
  2. Replace the split-column with a simple grid/multi-column widget type supported inside groups
  3. If side-by-side layout inside a container is required, restructure using two groups in a split-column at the top level

Example fix

# before
- type: group
  widgets:
    - type: split-column
      widgets: [...]

# after
- type: split-column
  widgets:
    - type: group
      widgets: [...]
Defensive patterns

Strategy: validation

Validate before calling

for w in group.get('widgets') or []:
    if w['type'] == 'split-column':
        raise ValueError('split columns inside of groups are not supported')

Prevention

When it happens

Trigger: A group widget whose widgets list contains an item with type: split-column; typically from pasting a split-column block into a group while reorganizing a page.

Common situations: Wanting side-by-side content inside a group and reaching for split-column; converting a region of a page into a group without removing an existing split-column.

Related errors


AI-assisted analysis of glanceapp/glance@91324e8de7 (2026-08-15). Data as JSON: /api/errors/79b6c351566a607b. Report an issue: GitHub.