Understand the key building blocks of every Spokbee configurator.
Every Spokbee product is built from a handful of core concepts. Once you understand these, the rest of the platform becomes intuitive.
A configurator is a published product that customers can interact with. It combines parameters, pricing rules, constraints, and visual assets into a single experience. Each configurator has its own URL and can be embedded on any website.
Parameters are the choices your customers make — things like color, size, material, or add-on features. Spokbee supports 7 parameter types: Select (dropdown), Radio, Color, Toggle, Slider, Number, and Text. Parameters can be organized into groups (collapsible sections) and can show or hide other parameters based on the customer's selections.
The schema is the JSON structure that defines your entire product configuration. It contains all parameters, their options, default values, pricing rules, constraints, and asset assignments. When you use the builder UI, you are editing the schema visually. Advanced users can also edit the schema directly as JSON.
The schema is version-controlled. Every time you publish, a new version is saved. You can view and roll back to any previous version from the builder.
Constraints are rules that limit which combinations of parameters are valid. For example, you might require that “outdoor use” is only available with weather-resistant materials, or that width times height cannot exceed a manufacturing limit. Spokbee supports 6 constraint types, from simple requires/excludes to arithmetic expressions.
Assets are images and 3D models that change based on the customer's selections. You assign assets to specific parameter combinations — when the customer picks “Red” and “Large”, the matching image appears. You can also designate a default asset that shows when no specific match is found.
A quote is a PDF document that captures the buyer's configuration, pricing breakdown, and optional notes. It can be emailed to the buyer and stored in your quotes dashboard. Quotes support digital signatures, custom PDF templates, and approval workflows.
Tip: Think of the relationship like this: a configurator owns a schema, the schema defines parameters, parameters have constraints and pricing rules, and assets are assigned to parameter combinations.