> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwoty.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Guided selling

> Reference for guided selling journeys: structure, group and option types, rules, formulas, pricing, activation checks and what happens on the quote.

## Overview

A **guided selling** is a journey of questions attached to a quote template. Instead of adding sections and products by hand, the sales rep answers questions screen by screen. Qwoty applies your rules, picks the products, computes prices and quantities, and shows a live summary. When the rep clicks **Validate**, the resulting sections and lines are added to the quote.

The journey only builds the **sections and lines** of the quote. Contracts, contents, discounts and payment terms still come from the template, and the quote stays fully editable afterwards.

> [!NOTE]
>
> Guided selling is in **Beta**. It's included in the Business, Pro and Enterprise subscriptions, and you need write access to templates to build one. To create one step by step, see [Set up guided selling](https://docs.qwoty.io/user-guide/templates/how-tos/guided-selling.md).

> [!TIP]
>
> Use guided selling to standardize a whole quote (several sections, one-off and recurring products, conditional choices). To make **one product** configurable, use the [product configurator](https://docs.qwoty.io/user-guide/catalog/reference/product-configurator.md). The two work together: a guided selling can contain configured products.

## How it works

```mermaid theme={null}
flowchart TD
A[Template] --> B[Guided selling: catalog + pricebooks]
B --> C[Steps = screens of the journey]
C --> D[Sections = quote sections]
D --> E[Phases, for subscription sections]
D --> F[Groups = questions]
E --> F
F --> G[Options = answers or products]
G --> H[Rules and formulas evaluate after each answer]
H --> I[Live summary]
I --> J[Validate: sections and lines added to the quote]
```

1. The admin builds the journey in the template's **Guided Selling** tab, then activates it.
2. When creating a quote, the rep picks the entry **Template - Guided selling** in the **Template** field.
3. The journey opens on the quote. After each answer, Qwoty re-evaluates every rule and formula and refreshes the summary.
4. **Validate** adds the sections and lines to the quote. The rep saves the quote, then edits it like any other.

## Structure

A guided selling is a tree. Each level has its own settings, edited in the **Settings** tab of the builder.

| Level | What it is | In the quote |
| - | - | - |
| **Guided selling** (the **Home** row) | Name, reference, API name, description, catalog, allowed pricebooks, channel, active status | Nothing directly |
| **Step** | One screen of the journey. It holds one or more sections. | Nothing: steps only organize the screens |
| **Section** | A block of questions on a step. Its type decides what it produces. | A quote section, except for **Open** sections |
| **Phase** | A period of a **Subscription** section, with an end (duration, fixed date or open-ended) | A phase of the subscription section |
| **Group** | A question or a list of products shown to the rep | Lines, for product groups |
| **Option** | A possible answer, a product or a configuration | One line (or several for a configured product) when selected |

### Guided selling settings

| Setting | Description |
| - | - |
| **Name** | Shown to sales reps after the template name, for example `France SMB - Workstation`. |
| **Reference**, **API name** | Your identifiers. The API name must be unique in the workspace. |
| **Description** | Internal description. |
| **Catalog** | One of the template's catalogs. Every product of the journey comes from it. It's set at creation and can't be changed. |
| **Pricebooks** | The template pricebooks linked to this catalog that the journey may run on, with one **default**. |
| **Channels** | **Quote**. At least one channel stays active. |
| **Active** | Only an active guided selling is offered when creating a quote. See [Activation checks](#activation-checks). |

A guided selling is created **Inactive**.

### Section types

| Type | Produces | Accepts |
| - | - | - |
| **Products** | A quote section of one-off lines | Question, Calculated, Product and Configured product groups. Product groups only accept **one-off** products. |
| **Subscription** | A subscription section, split into phases | Question and Calculated groups at section level. Product and Configured product groups go **inside a phase** and only accept **recurring** products. |
| **Open** | No quote section. Use it for questions that only drive rules, such as qualification questions. | Question and Calculated groups |

Section settings mirror the quote section: **Name**, **Section type** (**Standard** or **Optional**, with **This optional pack is selected**), **Hide subtotal**, **Hide line item price details**, **Line display** and **Metadata**.

A **Subscription** section also has a **Billing frequency**. Its first phase sets the subscription **Start** (on signature, a number of days after signature, or a fixed date). Each phase sets its **End type**: **Duration**, **Fixed date** or **Open-ended**. A Subscription section needs at least one phase.

### Order matters

Groups are read in a single global order: steps from top to bottom, then sections, phases and groups in the order of the tree. Drag rows in the **Tree** tab to reorder them. This order decides what a rule or formula can read (see [What an expression can read](#what-an-expression-can-read)).

## Group types

Choose the type when you add a group. It can't be changed afterwards.

| Type | Purpose | Creates quote lines |
| - | - | - |
| **Question** | An answer that drives rules and formulas | No |
| **Calculated** | A value computed by a formula, shown to the rep or kept hidden | No |
| **Product** | Products to add to the quote | Yes, one line per selected product |
| **Configured product** | A product configuration that the rep completes in a sub-step | Yes, a parent line and its child lines |

### Group settings

| Setting | Description |
| - | - |
| **Name** | The question shown to the rep. |
| **Required** | The step can't be completed without an answer. For a single choice, exactly one option; for a multiple choice, at least one; for an input, a non-empty value. |
| **Selection type** | How the options are displayed. See the table below. |
| **Minimum selections**, **Maximum selections** | Only for multiple-choice types. |
| **Tooltip** | Help shown next to the question. |
| **Sales tip** | An advice block for the rep, shown under the question. |
| **Visible during journey** | Turn it off to hide the group from the rep while keeping it in the logic. A hidden Product group can still add products through **Required** rules. |
| **Product list** | Product groups only: **Declared options** or **Dynamic search**. |

### Selection types

| Selection type | Choice | Question | Product, Configured product |
| - | - | - | - |
| **Radio buttons** | Single | Yes | Yes |
| **Dropdown** | Single | Yes | Yes |
| **Cards (single choice)** | Single | Yes | Yes |
| **Checkboxes** | Multiple | Yes | Yes |
| **Multi-select list** | Multiple | Yes | Yes |
| **Cards (multiple choice)** | Multiple | Yes | Yes |
| **Toggle** | Single, 2 options at most | Yes | No |
| **Number input** | Free input | Yes | No |
| **Free text** | Free input | Yes | No |
| **Date** | Free input | Yes | No |

A single-choice group that isn't required shows **Clear**, to remove the answer.

## Option types

The group type decides what its options are.

| Group | Option | Settings |
| - | - | - |
| **Question** | An answer | **Label**, **Description**, **Answer value**. Input types (number, text, date) have no options. |
| **Calculated** | Exactly one value | A value formula and a **Display format**: **Number**, **Amount** or **Percentage**. |
| **Product** | A catalog product variant | **Resource**, then price and quantity (below). Name and description come from the product. |
| **Configured product** | A product configuration | **Resource**. The rep completes the configuration in a sub-step, using its own groups, rules and prices. |

### Price and quantity of a product option

| Setting | Modes |
| - | - |
| **Price** | **Inherited from pricebook** (the price in the quote's pricebook), **Formula**, **Fixed amount** (excl. tax) |
| **Quantity** | **Fixed amount** (default 1) or **Formula**. The quantity is never inherited. |

Line settings, copied to the generated quote line:

| Setting | Effect |
| - | - |
| **Editable by sales** | The rep can override the unit price in the journey summary. |
| **Pay-as-you-go** | The line is billed on usage. |
| **Quantity editable by sales** | The rep can change the quantity in the summary, within the min and max. |
| **Optional quote line** | The line is optional on the quote; the customer can include it or not. |
| **Selected by default** | The optional line starts checked. Requires **Optional quote line**. |
| **Quantity editable by customer** | The customer can change the quantity in the DealRoom. |
| **Min quantity**, **Max quantity** | Bounds, shown when the quantity is editable by the rep or the customer. |

These settings shape the quote line. They don't change what the rep can select during the journey.

### Dynamic search

With **Dynamic search**, the Product group has no declared options. The rep searches the catalog and picks products directly.

* Results are limited to the guided selling's catalog, to the billing type of the group's location (one-off or recurring) and, if set, to the **Search categories**.
* Every picked product gets the price from the pricebook and a starting quantity of 1.
* One set of line settings, on the **Search lines** row of the tree, applies to every picked product. Min and max must include 1.
* Dynamic search products can't carry rules. To switch a group to dynamic search, delete its declared options first.

## Rules

A rule follows the pattern **IF \[condition] → THEN \[action]**, with an optional **ELSE** action. It always acts on the item that holds it. To make "answer B adds product C", put a **Required** rule on option C, with the condition "B is selected".

Add a rule from the **Settings** tab of the item, with **Add rule**. Click **Raw text** to type the expression yourself, for example:

```text theme={null}
IF({group_option.<group-id>.value} = "<option-id>", SHOW)
```

### Actions

| Action | Step | Section | Phase | Group | Option |
| - | - | - | - | - | - |
| **Show** | Yes | Yes | Yes | Yes | Yes |
| **Hide** | Yes | Yes | Yes | Yes | Yes |
| **Required** | No | No | No | No | Yes |
| **Exclude** | No | No | No | No | Yes |
| **Info banner**, **Warning banner**, **Error banner**, **Success banner** | No | No | Yes | Yes | No |

* **Show**: the item is hidden until the condition is true. An item that only has **Show** rules starts hidden.
* **Hide**: the item is hidden while the condition is true.
* **Required**: the option is selected and locked. In a single-choice group it replaces the rep's choice. A condition that's always true (`TRUE`) adds a product unconditionally.
* **Exclude**: the option is grayed out and can't be selected. If it was selected, it's removed.
* **Banners**: display a message on the phase or group. An **Error banner** doesn't block the journey.

### When rules conflict

| Active effects on the item | Result |
| - | - |
| **Exclude**, with or without other effects | Grayed out and unselectable. **Required** is ignored, and the option stays visible even if **Hide** is active. |
| **Required** and **Hide** | Hidden. The option isn't added to the quote. |
| **Required** alone | Selected and locked. |
| **Hide** and **Show** | Hidden: **Hide** wins. |
| **Show** | Visible. |
| No active rule, only **Show** rules | Hidden. |
| No active rule, other cases | Visible. |

Two **Required** options active at the same time in a single-choice group block the step, with the message "Several options imposed at the same time".

### Hidden items

A hidden item produces nothing, validates nothing and blocks nothing, and this cascades: a hidden step hides its sections, a hidden section its phases and groups, and so on. A required group that's hidden doesn't block the step. A step with no visible section is skipped.

### What an expression can read

Rules and formulas can only read groups that come **earlier** in the global order, whatever their step or section.

| Expression on | Can read |
| - | - |
| Step, section, phase | Groups before the first group of that item |
| Group | Earlier groups and the group itself, for example a banner that reacts to its own answer |
| Option (rule, price or quantity formula) | Groups strictly before the option's group |

Two exceptions in the option's own group: a price or quantity formula can read its own option's **Pricebook price**, and a price formula can read its group's **Quantity**, for volume prices. A quantity formula that reads its own group's quantity is refused, since it would loop.

### Evaluation order

After each answer, Qwoty evaluates rules in the order they were created, then recomputes selections, in **two passes**. It then recomputes prices, quantities and calculated values a last time, without re-evaluating rules. Chains of rules that read the earlier part of the journey are always resolved. A long chain where a rule of the second pass adds a product that feeds another rule may not settle completely.

## Formulas

A formula returns a number. It's used for an option's **price** or **quantity**, and for the value of a **Calculated** group. Formulas use the same editor, syntax and functions as the [product configurator](https://docs.qwoty.io/user-guide/catalog/reference/product-configurator.md#formulas): `IF`, `AND`, `OR`, `ROUND`, arithmetic and comparisons. Click **Insert variable** to add a variable without typing its identifier.

### Variables

| Variable | Syntax | Value |
| - | - | - |
| Group **Value** | `{group_option.<id>.value}` | The selected option's identifier (a comma-separated list for multiple choice), the typed value, or the calculated result. Empty if nothing is selected. |
| Group **Count** | `{group_option.<id>.count}` | Number of selected options. |
| Group **Price**, **Quantity**, **Total** | `{group_option.<id>.price}` | Sums over the selected lines of a Product group. |
| Option **Price**, **Quantity**, **Total** | `{option.<id>.price}` | The option's line. **0 if the option isn't selected.** |
| Option **Pricebook price** | `{option.<id>.list_price}` | The product's unit price in the quote's pricebook, selected or not, before formula and manual adjustment. Formulas only, not rules. |

There's no base product in a guided selling, so the base product variables of the product configurator don't exist here.

### Comparing a multiple-choice group

With `=` and `!=`, a multiple-choice group tests whether an option is **part of** the selection:

| Expression | True when |
| - | - |
| `{group_option.B.value} = "B1"` | B1 is selected, alone or with others |
| `{group_option.B.value} != "B1"` | B1 isn't selected, including when nothing is |
| `AND({group_option.B.value} = "B1", {group_option.B.count} = 1)` | Only B1 is selected |

Compare to one option at a time: two lists can't be compared with each other.

### Examples

| Formula | Result |
| - | - |
| `{option.<A1>.list_price} * 0.95` | 5% off the pricebook price of the option |
| `IF({group_option.<A>.quantity} > 10, {option.<A1>.list_price} * 0.9, {option.<A1>.list_price})` | 10% off when more than 10 units are selected in the group |
| `{group_option.<Users>.value}` | Quantity equal to the number typed in a **Number input** question |
| `ROUND({group_option.<Hardware>.total} * 0.15, 2)` | A calculated value worth 15% of the hardware total |

## Pricing

* **Pricebook.** The journey runs on the quote's pricebook, chosen at creation among the guided selling's pricebooks. It doesn't change during the journey.
* **Billing frequency.** A one-off group reads one-off prices. A group inside a phase reads the prices for its subscription's billing frequency. The same product can therefore have different prices in two subscriptions.
* **Price models.** Flat, volume, graduated and cost-based prices are computed like on the quote, at the line quantity.
* **Percent prices.** A percent price depends on the other quote lines. Rules and formulas read it as 0; the real amount appears in the summary and on the quote.
* **Missing price.** A product without a price in the pricebook stays visible at 0, with the warning "Missing pricebook price".
* **Invalid products.** Archived products, products outside the catalog and products of the wrong billing type are hidden from the journey.
* **Configured products.** A configured product becomes a parent line priced at the total of its configuration, with the base product and each priced option as child lines.

### Summary

The **Summary** shows the lines by section and phase, with unit price, quantity and subtotals, then:

* **One-off total**: the net total of the Products sections.
* **MRR**: the monthly equivalent of the recurring lines of the first visible phase of each subscription.
* **Warnings**: missing prices, invalid products, rules that can't be read.

## Activation checks

When you turn on **Active**, Qwoty checks the whole journey. Errors block the activation; warnings don't. An active guided selling is checked again after every change: if a change introduces an error, it's **deactivated** and the builder tells you.

| Check | Severity |
| - | - |
| Missing price in a pricebook (0 applied) | Warning |
| An expression reads the price of a percent-priced option (0 during the journey) | Warning |
| Broken reference, unparsable expression, reference outside the readable scope | Error |
| Quantity formula reading the quantity of its own group | Error |
| Resource not found, archived, outside the catalog, or with an incompatible billing type | Error |
| Group or phase in an invalid place, Subscription section without phase | Error |
| Invalid selection type, Calculated group without formula or with several options | Error |
| Required group always hidden, or hidden from the journey without enough **Required** rules | Error |
| Several options imposed at the same time in a single-choice group | Error |
| **Formula** mode without a formula, for the price or the quantity | Error |
| **Selected by default** without **Optional quote line**, invalid quantity bounds | Error |
| Default pricebook inactive, deleted, or removed from the template or catalog | Error |

## On the quote

### Availability

A guided selling is offered in the **Template** field of **New quote** when:

* the subscription includes guided selling;
* the guided selling and its template are active;
* its **Quote** channel is on;
* its catalog and at least one of its pricebooks are available to the customer.

Choosing it sets the catalog and preselects the default pricebook. It isn't offered when duplicating a quote.

### The journey

* **First opening.** The journey opens as soon as the quote opens, before the quote is shown. It's mandatory: it can't be closed until the rep clicks **Validate**. Until the quote is saved with lines from the journey, it opens again each time the quote is opened.
* **Validate** is available on the last step, once every visible step is complete. The sections and lines go after the existing ones, as manual prices.
* **Guided selling** button: replays the journey from scratch. Answers are never kept. If the quote already has lines from this journey, Qwoty asks **Replace the previous journey?**, then removes those lines (even if edited by hand) and their child lines before inserting the new ones. Lines added manually are kept.
* **Pricebook change.** If the rep changes the quote's pricebook, the quote must be saved before the journey can run again.

### After validation

* The quote is a standard quote: every line and section can be edited.
* Prices are manual: changing the pricebook later doesn't change them, and the quote markup doesn't apply to them.
* The quote stays limited to the guided selling's catalog and pricebooks in the quote settings.
* Deactivating or deleting the guided selling, or a subscription that no longer includes it, removes the **Guided selling** button. Lines already added stay.
* Duplicating a quote doesn't copy the link to the guided selling.

## Common questions

> [accordion] How do I add a product automatically, without asking the rep?
>
> Put the product in a Product group, then add a **Required** rule on the option with the condition that should add it. To hide the group from the rep, turn off **Visible during journey**.

> [accordion] Can a rule read a question asked later in the journey?
>
> No. Rules and formulas only read earlier groups. Move the question earlier in the tree.

> [accordion] Why is my item hidden although no rule is true?
>
> An item that only has **Show** rules is hidden until one of them is true. Add the right condition or remove the rule.

> [accordion] Are the answers saved?
>
> No. Only the lines added to the quote are kept. Replaying the journey starts from scratch.

> [accordion] What if the guided selling changes while a rep is running it?
>
> The open journey keeps the version loaded when it opened. The change applies the next time the journey opens.

> [accordion] Is a guided selling copied when I duplicate its template?
>
> No. Duplicating a template doesn't copy its guided sellings. Deleting a template deletes them.

## Related

> [card] [Set up guided selling](https://docs.qwoty.io/user-guide/templates/how-tos/guided-selling.md)
>
> Step-by-step guide to build, test and use a journey.

> [card] [Product configurator](https://docs.qwoty.io/user-guide/catalog/reference/product-configurator.md)
>
> Configurable products used in Configured product groups.

> [card] [Template settings](https://docs.qwoty.io/user-guide/templates/reference/template-settings.md)
>
> Catalogs, pricebooks and terms of the template.

> [card] [Pricing types](https://docs.qwoty.io/user-guide/catalog/reference/pricing-types.md)
>
> Flat, volume, graduated and percent prices.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.