Skip to main content

Configurator Menu Customization (sup_uiMenuComponentCustomization)

How to control which components appear in each configurator menu tab and in what order, using the sup_uiMenuComponentCustomization table in Boost.

What does this table do?

The sup_uiMenuComponentCustomization table lets you control which options appear in the configurator's side panel tabs, and in what order. Examples of what you can do:

  • Move Frame Spacing from the Style tab into the Materials tab

  • Move Frame Spacing into the Doors & Windows tab

  • Reorder options within a tab (e.g. put Roof Pitch before Roofing)

  • Remove the default options from a tab and define a completely custom layout

The most important concept — two separate layers

Every configurator menu has two completely separate layers of content. This table only controls one of them.

Layer

What it is

Can this table move it?

Platform content

Always-present options built into the menu by Boost (e.g. the Siding picker in Materials, the Width/Length/Height inputs in Size, the Color pickers in Colors, the wall editor in Doors & Windows)

❌ No — always shown, cannot be moved or removed

Configurable options

Options that can be placed, moved, or reordered across tabs — like Frame Spacing, Roof Pitch, Roof Overhang, Wind Bracing, etc.

✅ Yes — this is what the table controls

⚠️ This table cannot move platform content. For example, the Siding panel picker will always appear in the Materials tab regardless of anything in this table. You can add other options around it, but you cannot remove it or move it to a different tab.

What's always in each tab (platform content)

The following content is hardcoded into each menu by Boost. It cannot be affected by this table:

Tab

Always present (platform content)

Style

Style icon picker and style group selector

Size

Width, Length, and Eave Height inputs

Materials

Side Wall Siding Panels picker, Gauge, Engineer Certified, and Snow Load selectors

Colors

All color group pickers

Doors & Windows

Wall editor and building layouts

Interior

Insulation, Interior Wall, Interior Roof, and Loft selectors

Sections Properties

Fully Enclosed / Fully Open / Gable Ends / Custom wall shortcuts, tack room button, storage button, and lean section grid

What options can you move — and where can they go?

The options you can control with this table are called configurable options. Each platform (carports and sheds) has its own list. An option can be placed in any of the tabs listed for that platform.

⚠️ Key names must match exactly. Two common mistakes: the truss type selector key is trusses (not truss), and the trim selector key is trim-package (not trim). Using the wrong spelling causes the row to be silently ignored with no error.

Carports — configurable options you can place and move

These 18 options can be placed in any carport tab listed in the next section:

Option key

What it is

installation-surface

Installation surface selector

roofing

Roofing material

roof-pitch

Roof pitch selector

roof-snoop

Roof snoop

bracket

Bracket style

frame-spacing

Frame and truss spacing options (both live here)

roof-overhang

Roof overhang

rain-gutter

Rain gutter

trusses

Truss type/style selector (e.g. sunburst, triple wide, commercial) — not truss spacing. ⚠️ Key is trusses (with an s) — truss is silently ignored. Best placed in Style or Doors & Windows; avoid Materials, Size, Colors, and Interior tabs.

leg

Leg style

leg-footprint

Leg footprint

ceiling

Ceiling

panel-gauge

Panel gauge

brace

Brace

roof-extension

Roof extension

trim-package

Trim package. ⚠️ Key is trim-packagetrim is silently ignored.

wind-bracing

Wind bracing

j-trim

J-trim

⚠️ Any option key not in this list will be silently ignored — no error message, it simply won't appear.

Carports — which tabs can receive configurable options

You can place any of the 18 carport options above into any of these tabs:

  • Style — default tab for most of the 18 options. This is where they appear unless you move them.

  • Size — appears after the platform Width/Length/Height inputs

  • Materials — appears after the platform Siding/Gauge/Snow Load pickers

  • Doors & Windows — appears after the platform wall editor

  • Colors — appears after the platform color pickers

  • Interior — appears after the platform interior pickers

  • Sections Properties — default tab for wind-bracing and j-trim

Sheds — configurable options you can place and move

These 23 options can be placed in any shed tab listed in the next section:

Option key

What it is

installation-surface

Installation surface

siding-group

Siding group selector

siding

Siding picker

trim-package

Trim package. ⚠️ Key is trim-packagetrim is silently ignored.

porch

Porch option

porch-depth

Porch depth

porch-length

Porch length

porch-sidewall-depth

Porch sidewall depth

porch-railing

Porch railing

sidewall-height

Wall height (sidewall height)

roofing

Roofing material

roof-pitch

Roof pitch

roof-snoop

Roof snoop

bracket

Bracket style

roof-overhang

Roof overhang

rain-gutter

Rain gutter

ceiling

Ceiling

roof-extension

Roof extension

base

Base option

skylight

Skylight (default: Doors & Windows tab)

insulation

Insulation (default: Interior tab)

flooring

Flooring — always shown in the Flooring tab; cannot be repositioned

floor-joist

Floor joist — always shown in the Flooring tab; cannot be repositioned

⚠️ Any option key not in this list will be silently ignored — no error message, it simply won't appear.

Sheds — which tabs can receive configurable options

  • Style — default tab for most shed options

  • Size — appears after the platform Width/Length/Height inputs

  • Doors & Windows — default tab for skylight

  • Colors — appears after the platform color pickers

  • Interior — default tab for insulation

How each column works

Column

What it does

component

The option key you are placing (e.g. frame-spacing). Must match the exact key in the valid list above — even a small spelling difference causes the row to be silently ignored.

menu

Which tab the option should appear in (e.g. material, doors-windows, style). Must be a valid target tab for this platform.

priorComponent

What option should come immediately before this one. Leave blank / null to make it first in the tab. This is how ordering works — the order column is ignored in Boost.

doNotAddDefaultComponents

Set to 1 to suppress the tab's default options and start from scratch. Set to 0 to keep defaults and add your option on top. See the section below for important caveats.

control

How the option is displayed: radio (default), dropdown, or compact-dropdown.

enabled

Standard on/off toggle. Disabled rows are filtered out by the authoring API before data reaches Boost — unchecking a row stops it from taking effect.

order

⚠️ Ignored in Boost. This was used by the old classic configurator. For ordering in Boost, use priorComponent only.

Tabs with default configurable options

Most tabs start with no default configurable options — you place everything manually. The following tabs come pre-populated with default options that you can reorder, remove (using doNotAddDefaultComponents), or add to:

Tab

Platform

Default configurable options

Style

Carports

All 16 carport option keys (installation-surface, roofing, roof-pitch, roof-snoop, bracket, frame-spacing, roof-overhang, rain-gutter, trusses, leg, leg-footprint, ceiling, panel-gauge, brace, roof-extension, trim-package)

Style

Sheds

All 19 shed style keys (installation-surface, siding-group, siding, trim-package, porch, porch-depth, porch-length, porch-sidewall-depth, porch-railing, sidewall-height, roofing, roof-pitch, roof-snoop, bracket, roof-overhang, rain-gutter, ceiling, roof-extension, base)

Sections Properties

Carports

wind-bracing, j-trim

Doors & Windows

Sheds

skylight

Interior

Sheds

insulation

All other tabs (Size, Materials, Colors, Doors & Windows for carports, Interior for carports, etc.) have no default configurable options. They show only platform content unless you explicitly add options via this table.

When to suppress defaults (doNotAddDefaultComponents)

Setting doNotAddDefaultComponents = 1 on a row tells Boost: "Don't show the default options for this tab — only show what I've explicitly defined."

When this setting matters: Only on tabs that have default configurable options (see table above — Style, Sections Properties for carports; Style, Doors & Windows, Interior for sheds). Using it on any other tab has no effect because there are no defaults to suppress.

What it does NOT affect: Platform content (siding picker, size inputs, color pickers, wall editor, etc.) is always shown regardless of this setting. doNotAddDefaultComponents only suppresses configurable options, not platform content.

⚠️ Important: If any row for a tab has this set to 1, it suppresses defaults for the entire tab — not just that one row. Do not mix 0 and 1 on rows targeting the same tab.

How ordering works (priorComponent)

The order column you may see on existing rows is completely ignored in Boost. Ordering is controlled entirely by the priorComponent column, which works like a linked list:

  • priorComponent is blank or null → this option goes first in the tab

  • priorComponent: "roof-pitch" → this option goes immediately after roof-pitch

  • Only one row per tab should have a blank/null priorComponent. Multiple blank entries cause unpredictable ordering.

  • If the referenced component doesn't appear in the resolved list, the option is added at the end.

Common scenarios

"I want to move Frame Spacing into the Materials tab"

Add a row: component = frame-spacing, menu = material, priorComponent = null (or after another option already in Materials), doNotAddDefaultComponents = 0.

Frame Spacing will appear below the always-present Siding / Gauge / Snow Load pickers. Note: frame-spacing renders both frame spacing and truss spacing options in a single block.

"I want to move Frame Spacing into the Doors & Windows tab"

Add a row: component = frame-spacing, menu = doors-windows, priorComponent = null, doNotAddDefaultComponents = 0.

Frame Spacing will appear below the always-present wall editor.

"I want complete control over what appears in the Style tab"

Add one row per option you want to show, each with doNotAddDefaultComponents = 1. The first option should have priorComponent = null. Each subsequent option's priorComponent points to the one before it.

⚠️ All rows for that tab must have doNotAddDefaultComponents = 1 — if even one row has 0, defaults are still suppressed for the whole tab.

"An option isn't showing up even though I added a row"

Check these in order:

  1. Is the component key spelled exactly as listed in the valid key table above? Common mistakes: truss instead of trusses, trim instead of trim-package. Wrong spellings are silently ignored with no error.

  2. Is the menu value a valid target tab for this platform? (Targeting an unsupported tab is also silently ignored.)

  3. Is the priorComponent value pointing to an option that will actually be in that tab's resolved list?

  4. Are all rows for this tab consistent on doNotAddDefaultComponents?

  5. If the option is trusses — is it being placed in Style or Doors & Windows? Placing it in Materials, Size, Colors, or Interior will cause it to render without the section context it needs.

  6. Does the supplier have other enabled rows for this same component pointing to a different tab? That row would move the component there instead. Disabled rows are excluded and won't interfere.

Note: if the option you're looking for is platform content (e.g. the Siding picker, size inputs, color pickers), it cannot be moved via this table at all — it's hardcoded.

Quick checklist before saving rows

  • component key is spelled exactly right — trusses (not truss), trim-package (not trim)

  • menu is a valid target tab for this platform (not flooring-interior — use flooring)

  • priorComponent chain is correct — one null per tab, each option points to the one before it

  • doNotAddDefaultComponents is consistent across all rows for the same tab

  • ✅ No other enabled rows exist for the same component pointing to a different tab

  • ✅ Not relying on the order column — it has no effect in Boost

  • ✅ If using trusses — placing it in Style or Doors & Windows, not in Materials/Size/Colors/Interior

Did this answer your question?