# Combeenation Docs
> Create configurators at rocket speed
This file contains links to documentation sections following the llmstxt.org standard.
## Table of Contents
- [AI skills](https://docs.combeenation.com/docs/ai/ai-skills): AI skills give your AI agent in-depth knowledge of the Combeenation platform. They follow the open Agent Skills format, which is supported by many ...
- [Getting started with AI](https://docs.combeenation.com/docs/ai/getting-started-with-ai): You can make use of AI tools in several ways: through assistants built into the Combeenation platform, through your own AI agent connected to Combe...
- [MCP server](https://docs.combeenation.com/docs/ai/mcp-server): The Combeenation MCP server connects your AI agent to the Combeenation platform via the Model Context Protocol. With it, your agent can explore you...
- [Basic workflow](https://docs.combeenation.com/docs/asset-management/3d-and-material-assets/basic-workflow): You can upload `.glb` and `.babylon` files to create a 3d asset.
- [Decals](https://docs.combeenation.com/docs/asset-management/3d-and-material-assets/decals): "Decals" are used to create details, like **badges** or **logos** on existing meshes.
- [Assign asset bundles to configurators](https://docs.combeenation.com/docs/asset-management/assign-asset-bundles-to-configurators): To use an asset in a configurator, you must first allow the configurator to access it. This is done by **assigning** the asset bundle that contains...
- [Basics](https://docs.combeenation.com/docs/asset-management/data-source-asset/basics): A data source contains tabular data that can be selectively loaded and filtered in a configurator with a table component.
- [JSON-based data sources](https://docs.combeenation.com/docs/asset-management/data-source-asset/json-based-data-sources): A JSON document does not contain tabular data, unlike a CSV or XLS file, which is why data sources based on them work a little different.
- [Tips for translation data sources (i18n)](https://docs.combeenation.com/docs/asset-management/data-source-asset/tips-for-translation-data-sources): If you want your configurator to be available in multiple **languages**, we recommend to store **translations** in a data source.
- [Getting started with assets](https://docs.combeenation.com/docs/asset-management/getting-started-with-assets): Assets are files that you can use when building a configurator. Images are one of the most common assets. Another common kind is the data source, w...
- [PDF asset](https://docs.combeenation.com/docs/asset-management/pdf-asset): A PDF asset can be used to build PDFs based on HTML Liquid templates. Liquid is an open-source template language created by Shopify.
- [Text asset](https://docs.combeenation.com/docs/asset-management/text-asset): A text asset can contain large amounts of textual data. You can work with its text content in a configurator (unlike the contents of a file asset)....
- [Insights](https://docs.combeenation.com/docs/configuration-insights/configuration-insights-): We collect insights data for each configuration a user creates when they open the configurator
- [Personal Configurations](https://docs.combeenation.com/docs/configuration-insights/personal-configurations): A personal configuration belongs to a specific user on the Combeenation platform and can only be opened and edited by that user. The user must be a...
- [Components overview](https://docs.combeenation.com/docs/configurator-logic/components/components-overview): There are five different component types:
- [Graphic component](https://docs.combeenation.com/docs/configurator-logic/components/graphic-component): The graphic component allows you to create dynamic visualizations in the Scalable Vector Graphics (SVG) format and export them as JPG or PNG images.
- [Record component](https://docs.combeenation.com/docs/configurator-logic/components/record-component): A record component holds whole data sets in a tabular form. The structure of a record component can be defined by the user, i.e. any number/names o...
- [Resource component](https://docs.combeenation.com/docs/configurator-logic/components/resource-component): To access resources in the configurator, it is also necessary to store them in a component. There are the following 4 resource types that can be up...
- [Result visualization](https://docs.combeenation.com/docs/configurator-logic/components/result-visualization): The result panel automatically converts the output data in a human-readable format.
- [Table component](https://docs.combeenation.com/docs/configurator-logic/components/table-component): A Table component is used to load tabular data from a data source as well as filtering and modifying that data. This data is organized in a table o...
- [Value component](https://docs.combeenation.com/docs/configurator-logic/components/value-component): Different data types can be stored in a value component. The most simple of these are numbers, text, and logic. These can be simply selected in the...
- [Configuration variable](https://docs.combeenation.com/docs/configurator-logic/configuration-variable): Every time one of your customers uses your configurator or you try out a draft of it, a configuration is created. This configuration is used to aut...
- [Configurator & presets variable](https://docs.combeenation.com/docs/configurator-logic/configurator-and-presets-variable): Everything you create in the configurator editor is either directly or indirectly connected to your configurator. With the configurator variable yo...
- [Editor basics](https://docs.combeenation.com/docs/configurator-logic/editor-basics): On the left side of your configurator, you will find a list of components and groups. Each component is part of a group. For a better overview of y...
- [File upload & handling](https://docs.combeenation.com/docs/configurator-logic/file-upload-and-handling): You can allow users of your configurator to upload files. These files will be permanently linked to the current configuration and can be accessed i...
- [Hive introduction](https://docs.combeenation.com/docs/configurator-logic/hive-introduction): Hive is the language that is used to express the rules and logic of every Combeenation configurator. Hive was specially developed for mapping produ...
- [Hive language](https://docs.combeenation.com/docs/configurator-logic/hive-language): Each value in Hive is of a certain type, which determines what you can do with that value. It is a statically typed language, unlike JavaScript for...
- [Hive Queries](https://docs.combeenation.com/docs/configurator-logic/hive-queries): A query lets you load, filter, sort and reshape a collection of data with Hive code. Queries are most commonly used to load data from a data source...
- [Hash type](https://docs.combeenation.com/docs/configurator-logic/hive-types/hash-type): The hash type provides functions for generating hash codes with various hashing algorithms.
- [JSON type](https://docs.combeenation.com/docs/configurator-logic/hive-types/json-type): The JSON type allows you to store arbitrary JSON content, e.g. for use in Custom Code or to pass it on to external APIs.
- [List type](https://docs.combeenation.com/docs/configurator-logic/hive-types/list-type): A list contains multiple values of the same type. To create a list you just have to wrap a number of values in square brackets.
- [Locale type](https://docs.combeenation.com/docs/configurator-logic/hive-types/local-type): A locale is used to customize an application for a specific culture or region, in terms of language and formatting of texts, numbers etc. In Hive, ...
- [Logic type](https://docs.combeenation.com/docs/configurator-logic/hive-types/logic-type): A value of type logic is either true or false. It can be used to represent "yes or no" questions in your configurator (on/off, with/without, etc.)
- [Map type](https://docs.combeenation.com/docs/configurator-logic/hive-types/map-type): A map contains multiple values, each of which can be looked up by a key stored alongside it. In other words: keys are mapped to values, which is wh...
- [Math type](https://docs.combeenation.com/docs/configurator-logic/hive-types/math-type): The math type provides trigonometric and other advanced mathematical functions and constants. For commonly used, simple mathematical functions take...
- [Number type](https://docs.combeenation.com/docs/configurator-logic/hive-types/number-type): Numbers are used for all kinds of calculations. There are literal numbers, like `7` or `1.5`, but a component or variable can also be of type numbe...
- [QR code type](https://docs.combeenation.com/docs/configurator-logic/hive-types/qr-code): To use any of the functions described on this page, you must prefix them with the QRCode type name:
- [Text type](https://docs.combeenation.com/docs/configurator-logic/hive-types/text-type): In Hive, a text (often called “string” in other programming languages) must be surrounded with quotation marks (`”`). All the operations and functi...
- [Viewer3d type](https://docs.combeenation.com/docs/configurator-logic/hive-types/viewer3d-type): The `Viewer3d` type provides helper functions which can be used with slots of the Viewer 3d control.
- [The if expression](https://docs.combeenation.com/docs/configurator-logic/the-if-expression): The if expression allows you to perform different actions based on one or more conditions. In the example below, we calculate the price of a produc...
- [User variable](https://docs.combeenation.com/docs/configurator-logic/user-variable): The `user` variable contains information about the current user, provided they are signed into the Combeenation platform. Otherwise, the current us...
- [Accessibility](https://docs.combeenation.com/docs/configurator-ui-ux/accessability): Accessibility ensures that web applications like your configurator, are usable by everyone, including people with disabilities. This includes indiv...
- [3d viewer control with custom code](https://docs.combeenation.com/docs/configurator-ui-ux/controls/3d-viewer-control-with-custom-code): If you need more functionality than the 3d viewer control provides out of the box in the configurator editor, you can use custom code to extend it ...
- [3d viewer control](https://docs.combeenation.com/docs/configurator-ui-ux/controls/3d-viewer-control): The 3d viewer control gives you the power to **showcase your 3d models** in the configurator. It allows you to dynamically compose the shown scene ...
- [3d viewer docs](https://docs.combeenation.com/docs/configurator-ui-ux/controls/3d-viewer-docs): For detailed description of the 3D viewer api see the dedicated 3d viewer documentation.
- [Combobox](https://docs.combeenation.com/docs/configurator-ui-ux/controls/combobox): The combobox control allows you to present tabular data in an interactive dropdown list, showing a variety of options of which the user can chose one.
- [Configurator control](https://docs.combeenation.com/docs/configurator-ui-ux/controls/configurator-control): The configurator control is a static control which exists by default in every configurator and cannot be deleted or renamed. It has no visual repre...
- [Control DOM & CSS classes](https://docs.combeenation.com/docs/configurator-ui-ux/controls/control-dom-and-css-classes): - cfgr-ctrl - cfgrctrl-disabled
- [Dataview](https://docs.combeenation.com/docs/configurator-ui-ux/controls/dataview): The dataview control allows you to present tabular data in a visually appealing and user-friendly interface. You can seamlessly showcase informatio...
- [Social Share](https://docs.combeenation.com/docs/configurator-ui-ux/controls/social-share): The Share-Control is essentially a button with a fixed click behaviour. Based on the chosen platform it changes it's default design and opens the r...
- [Tooltips for controls](https://docs.combeenation.com/docs/configurator-ui-ux/controls/tooltips-for-controls): Tooltips can be set for most of the controls in the configurator editor to provide additional information to the user. To get started, simply creat...
- [Custom code](https://docs.combeenation.com/docs/configurator-ui-ux/custom-code/custom-code-): With custom code you can **extend your configurators capabilities** in many ways. It allows you to write TypeScript which then runs in your configu...
- [Quick start](https://docs.combeenation.com/docs/configurator-ui-ux/custom-code/quick-start): The following guide assumes that the following prerequisites are met. Otherwise please see the more detailed guide about Custom Code.
- [CSS properties (variables)](https://docs.combeenation.com/docs/configurator-ui-ux/custom-css/css-properties-variables): All browsers which are officially supported browsers also support CSS properties (variables). Therefore you can basically use them as you wish in y...
- [Load mask styles](https://docs.combeenation.com/docs/configurator-ui-ux/custom-css/load-mask-styles): The configurator automatically displays a load mask in several situations to inform users that background tasks are in progress.
- [Create PDF from HTML content](https://docs.combeenation.com/docs/configurator-ui-ux/customjs/create-pdf-from-html-content): The custom-js-utils function CfgrUtils.convertHtmlToPdf allows you to create a fully custom PDF, based on any valid HTML input. This can be useful ...
- [Custom JS](https://docs.combeenation.com/docs/configurator-ui-ux/customjs/custom-js): With custom JS, which is short for custom JavaScript, you can **extend your configurators capabilities** in many ways. It allows you to write JavaS...
- [Headless configurator](https://docs.combeenation.com/docs/configurator-ui-ux/headless-configurator): If you want to provide all the configurator UI using your own tooling, frameworks & libraries instead of using our built in UI editor, you can do s...
- [User input sanitization](https://docs.combeenation.com/docs/configurator-ui-ux/user-input-sanitization): To prevent Cross-Site Scripting (XSS) attacks we've introduced a new paramter `Sanitize Value` for a wide range of `SigSlo` slots like...
- [3D/AR Viewer](https://docs.combeenation.com/docs/fundamentals/3d-ar-viewer): To display a 3D model with an included AR experience, the Combeenation platform offers a free 3D/AR viewer.
- [Configurations](https://docs.combeenation.com/docs/fundamentals/configurations): A configuration is created each time a user opens a configurator and is used to save the user's progress. This is done by saving all the user input...
- [Copying Configurators and Asset Bundles](https://docs.combeenation.com/docs/fundamentals/copying-configurators-and-asset-bundles): The export/copy functionality enables you to duplicate configurators and asset bundles for use in other companies where you are a member.
- [Create a basic 3D configurator](https://docs.combeenation.com/docs/fundamentals/create-a-basic-3d-configurator): The goal is to create a basic 3D Mokapot configurator. The user should be able to
- [Creating a configurator](https://docs.combeenation.com/docs/fundamentals/creating-a-configurator): As it is possible on the welcome page, you can also create a configurator by simply clicking on the `+ New configurator` button in your configurato...
- [Custom Fields](https://docs.combeenation.com/docs/fundamentals/custom-fields): Custom fields allow you to store additional data in different areas of your company:
- [Keyboard shortcuts](https://docs.combeenation.com/docs/fundamentals/keyboard-shortcuts): ---
- [User Permissions](https://docs.combeenation.com/docs/fundamentals/user-permissions): Every user can be assigned to multiple companies with its own individual role. Each role always includes the permissions of the preceding one.
- [Welcome](https://docs.combeenation.com/docs/fundamentals/welcome): After your first login or after simply **clicking on the Combeenation logo** in the upper left corner, the welcome page is shown immediately. This ...
- [Analytics](https://docs.combeenation.com/docs/integrations-and-api/analytics): Whilst there is no direct integration of a configurator in the Google Tag Manager (GTM), we provide a ready-to-use interface to forward certain con...
- [Flex checkout](https://docs.combeenation.com/docs/integrations-and-api/checkout-types/flex-checkout): Basically the flex checkout lets you decide which data (e.g. amount, description, generated images, ...) will be passed to the parent page when a u...
- [FTP checkout](https://docs.combeenation.com/docs/integrations-and-api/checkout-types/ftp-checkout): This Checkout shop can upload one or multiple files to a given FTP server. The uploading files are defined via a Hive record, with the following st...
- [Mail checkout](https://docs.combeenation.com/docs/integrations-and-api/checkout-types/mail-checkout): This checkout will send one or multiple mails on Checkout. The mails are defined via a Hive record, with the following structure:
- [REST checkout](https://docs.combeenation.com/docs/integrations-and-api/checkout-types/rest-checkout): This Checkout will perform up to five parallel REST requests to given endpoints. The endpoint should return successful HTTP code (200-299). Request...
- [Shopify](https://docs.combeenation.com/docs/integrations-and-api/checkout-types/shopify): We highly recommend utilizing our free Shopify app if you wish to sell customizable products online through your Shopify shop. The app offers a smo...
- [Shopware 6](https://docs.combeenation.com/docs/integrations-and-api/checkout-types/shopware-6): We highly recommend utilizing our free Shopware 6 plugin if you wish to sell customizable products online through your Shopware 6 shop. The plugin ...
- [WooCommerce](https://docs.combeenation.com/docs/integrations-and-api/checkout-types/woocommerce): The recommended method for implementing a checkout process in a WooCommerce shop is using the flex checkout approach. If assistance is needed with ...
- [Checkout](https://docs.combeenation.com/docs/integrations-and-api/checkout): The main purpose of the Checkout is to complete a configuration and export certain information/data from this configuration to the customer, shoppi...
- [Combeenation API](https://docs.combeenation.com/docs/integrations-and-api/combeenation-api): The Combeenation API is an interface which can be called programmatically with any possible HTTP REST client.
- [Configuration Finish](https://docs.combeenation.com/docs/integrations-and-api/configuration-finish): A configuration can be explicitly finished, which marks it as complete and triggers a number of user-defined actions such as sending mails, creatin...
- [Embedding & Whitelist](https://docs.combeenation.com/docs/integrations-and-api/embedding-and-whitelist): To embed a Configurator in a website, only two HTML tags (`