Analytical dimensions

Goal

Define analytical dimension types and values (cost centers, projects, and other tags) that are copied onto journal lines at post.

Who it is for

Users with dimension.view / dimension.manage. No separate module gate — lives under Commerce setup.

Preconditions

• Permission dimension.view to open the list; dimension.manage to create types/values.
• Decide which dimensions are required on every posting before go-live.

Steps — types

1. Open Administration → Settings → Analytical Dimensions (/dimensions).
2. New dimension: code (max 32), name (translatable), optional Required (“Require a value on every posting”).
3. Save — Dimension created.

Steps — values

1. Select a dimension and Add value: code + name.
2. Values are managed under /dimensions/{id}/values.

Result

Required dimensions must be supplied on sales/purchase (and related) lines before post. Missing values raise: "A value for the required dimension "{code}" must be supplied before posting." Values are copied to journal lines.

Hard stops

• Posting without a required dimension value → 422 commerce.dimension_required.
• Unknown / mismatched dimension value → commerce validation errors.

Related

• Recurring documents (line editors expose dimension options)
• Pending documents
• Sales invoices