Buildadocs
⌘K
GuidesAPI ReferenceIntegrationsChangelog

Custom Fonts

Custom Fonts are image-based typographies where each character is a separate image file mapped to a SKU in your ecommerce platform. This is ideal for physical personalisation — engraving, embossing, printing, or any process where individual characters are produced as discrete ite

Custom Fonts

Overview

Custom Fonts are image-based typographies where each character is a separate image file mapped to a SKU in your ecommerce platform. This is ideal for physical personalisation — engraving, embossing, printing, or any process where individual characters are produced as discrete items.

When to Use Custom Fonts

  • Engraved or embossed lettering on jewellery, accessories, or gifts
  • Printed characters on physical products
  • Any scenario where each character has a real production cost and inventory item

Creating a Custom Font

  1. Navigate to Typography in the sidebar
  2. Click Add Typography
  3. Select Custom Font as the typography option

Required Fields

FieldDescription
NameA descriptive name for this typography (e.g., "Gold Engraving Font")
PrefixA short identifier prepended to character SKUs (e.g., "GLD")
CurrencyThe currency used for pricing rules

Pricing Rules

Pricing rules define the cost of personalised text based on how many characters the customer enters. Each rule specifies a character count range and a price.

FieldDescription
Minimum CharactersThe lower bound of the range (inclusive)
Maximum CharactersThe upper bound of the range (inclusive)
PricingThe price charged when the character count falls within this range

Example — tiered pricing for engraving:

MinMaxPrice
1510.00
61018.00
112025.00

Pricing Rule Validation

Builda enforces these rules when saving:

  • No overlapping ranges — Each character count must fall into exactly one pricing tier
  • Minimum must be less than maximum — The lower bound cannot exceed the upper bound
  • Unique pricing values — Each tier must have a distinct price

Data Structure

Custom Font typographies store their pricing configuration as a JSON array:

[
  { "minimum_characters": 1, "maximum_characters": 5, "pricing": 10.00 },
  { "minimum_characters": 6, "maximum_characters": 10, "pricing": 18.00 }
]

After Creating a Custom Font

Once the typography is created, you need to add characters and optionally character sets. See Characters & Character Sets.

Next Steps