Buildadocs
⌘K
GuidesAPI ReferenceIntegrationsChangelog

Customisations

Customisations are the options available to customers when personalising a product component. These could be colours, materials, text input, font choices, or any other variable.

Customisations

Overview

Customisations are the options available to customers when personalising a product component. These could be colours, materials, text input, font choices, or any other variable.

Types of Customisations

Builda supports several customisation types that can be assigned to components within a configuration step:

TypeDescriptionExample
DropdownCustomer selects from a list of optionsChoose a material: Leather, Fabric, Rubber
Colour PickerCustomer selects a colourPick a strap colour
Text InputCustomer enters free-form textEnter your engraving text
Image UploadCustomer uploads an imageUpload a custom logo
TypographyCustomer personalises text using a configured fontChoose from character images or web font text

Typography Customisations

Typography is a specialised customisation type for text personalisation. It supports two modes:

  • Custom Font — Each character is an individual image mapped to a SKU. Ideal for engraving, embossing, and physical lettering.
  • Web Font — Text is rendered using a standard web font file. Ideal for on-screen previews and digital text styling.

For full details, see the Typography section.

Creating Customisations

Customisations are created within the context of a component. Each component in a configuration step can have one or more customisation options attached.

  1. Navigate to Product Configuration and select a product
  2. Open a configuration step
  3. Select a component
  4. Add customisation options to the component

Pricing

Customisations can affect product pricing in several ways:

  • Base price adjustments — A customisation choice adds to or overrides the base price
  • Surcharges — Additional cost for premium options (e.g., gold engraving vs silver)
  • Typography pricing rules — For Custom Font typographies, pricing is based on character count tiers (see Custom Fonts)

Constraints & Validation

You can set constraints on customisations to control what customers can enter:

  • Required fields — Mark customisations as mandatory
  • Character limits — Set minimum and maximum character counts for text input
  • Allowed values — Restrict selections to a defined set of options

Customisation + SKU Mapping

Each customisation choice can map to a SKU in your ecommerce platform. This enables:

  • Inventory tracking per option
  • Accurate order line items
  • Production routing based on selected options

For typography, each character and character set has its own SKU — see Characters & Character Sets.