> ## 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.

# Set up guided selling

> Build a question journey on a template that sales reps answer to fill the quote with the right sections, products and prices.

A **Guided Selling** is a journey of questions attached to a template. When a sales rep creates a quote with it, the journey opens on the quote: the rep answers the questions, Qwoty picks the products and computes the prices, and **Validate** adds the resulting sections and lines to the quote.

> [!NOTE]
>
> Guided selling is in **Beta**. It's included in the Business, Pro and Enterprise subscriptions. On other subscriptions, the **Guided Selling** tab of the template shows an upgrade banner.

## How a journey is built

A journey is a tree, edited in the **Tree** tab of the builder:

| Level | What it is |
| - | - |
| **Step** | One screen of the journey. The rep moves between steps with **Previous** and **Next**. |
| **Section** | A quote section created by the journey: **Products** (one-off lines), **Subscription** (recurring lines, split into **phases** with a billing frequency) or **Open**. |
| **Group** | A question shown to the rep. See the group types below. |
| **Option** | A possible answer. In a product group, each option is a product or a configured product. |

Group types:

* **Question**: an answer that drives rules and formulas, without adding a line. Displayed as **Radio buttons**, **Dropdown**, **Cards (single choice)**, **Checkboxes**, **Multi-select list**, **Cards (multiple choice)**, **Toggle**, **Number input**, **Free text** or **Date**.
* **Product**: products to add to the quote. The list is either **Declared options** (products you pick one by one) or **Dynamic search** (the rep searches the catalog, optionally limited to some categories).
* **Configured product**: a product configuration that the rep completes in a sub-step.
* **Calculated**: a value computed by a formula, which other rules and formulas can read.

## Prerequisites

* A template with at least one catalog and one pricebook linked to that catalog. See [Create a quote template](https://docs.qwoty.io/user-guide/templates/how-tos/create-quote-template.md).
* Write access to templates.

## Create the guided selling

**1. Open the Guided Selling tab**

In the side menu, click **Template**, open the template, then click the **Guided Selling** tab and **Add**.

**2. Fill in the New Guided Selling window**

![New Guided Selling window](https://mintcdn.com/qwoty-45352a33/5Fg9IpXmttZnaOHt/images/app/guided-selling-create.jpg?fit=max\&auto=format\&n=5Fg9IpXmttZnaOHt\&q=85\&s=af39ebfc3fa585f65dff6204f8e1ef68)

* **Name** \*: shown to sales reps next to the template name
* **Reference** (optional) and **API name** \*: the API name is generated from the name and must be unique in the workspace
* **Catalog** \*: one of the template's catalogs. All products of the journey come from it, and it can't be changed afterwards.
* **Pricebooks** \*: the template pricebooks linked to this catalog that the journey may use. Mark one as **default**.
* **Channels** \*: keep **Quote** checked

Click **Create**. The builder opens.

## Build the journey

**1. Add steps, sections and groups**

In the **Tree** tab, click **No step yet: add the first one to build the journey**. Then use the **+** button on each row: on a step to add a section, on a section to add a group, on a group to add an option.

Click a row, then the **Settings** tab, to edit it. For a group, you set the **Name**, **Required**, **Selection type**, minimum and maximum selections, a **Tooltip** and a **Sales tip**. For a product option, you choose the **Resource** (the product), the price source (**Inherited from pricebook**, **Formula** or **Fixed amount**) and the quantity.

Changes are saved as you go: the header shows **Saving…** then **Saved**.

**2. Add rules**

In the **Settings** tab of a step, section, phase, group or option, click **Add rule**. A rule reads: IF a group has a given answer, THEN an action, ELSE another action.

![Add rule window](https://mintcdn.com/qwoty-45352a33/5Fg9IpXmttZnaOHt/images/app/guided-selling-rule.jpg?fit=max\&auto=format\&n=5Fg9IpXmttZnaOHt\&q=85\&s=6f3348abc2cc9b33a4da268eab432e3e)

| Action | Available on | Effect |
| - | - | - |
| **Show** | Step, section, phase, group, option | The item stays hidden until the condition is true |
| **Hide** | Step, section, phase, group, option | The item is hidden while the condition is true |
| **Required** | Option | The option is selected and can't be cleared |
| **Exclude** | Option | The option can't be selected |
| **Info banner**, **Warning banner**, **Error banner**, **Success banner** | Phase, group | Displays a message on the phase or group |

When several rules apply, **Exclude** wins over everything, and **Hide** wins over **Show**. An item that only has **Show** rules stays hidden until one is true. See [Guided selling reference](https://docs.qwoty.io/user-guide/templates/reference/guided-selling.md#when-rules-conflict) for every case. Click **Raw text** to write the rule as an expression, for example `IF({group_option.<group-id>.value} = "<option-id>", SHOW)`.

**3. Test in the Preview tab**

The **Preview** tab plays the journey as a sales rep sees it, with the rules applied. Each step shows **Valid step** or **Incomplete step**. Click **Commercial journey** to open the full journey window with its **Summary**: lines, prices from the default pricebook, one-off total and MRR.

![Preview tab: the second product appears once the rep answers Yes](https://mintcdn.com/qwoty-45352a33/5Fg9IpXmttZnaOHt/images/app/guided-selling-preview.jpg?fit=max\&auto=format\&n=5Fg9IpXmttZnaOHt\&q=85\&s=06aa580ec9717eddbc20799bfea94d10)

**Validate** stays disabled in the preview, since there is no quote.

**4. Activate**

The header shows whether the guided selling is **Active** or **Inactive**. To activate it, click the **Home** row, open **Settings** and turn on **Active**. Qwoty checks the journey before activating it: errors block the activation, warnings don't.

![Activation check with a non-blocking warning](https://mintcdn.com/qwoty-45352a33/5Fg9IpXmttZnaOHt/images/app/guided-selling-activate.jpg?fit=max\&auto=format\&n=5Fg9IpXmttZnaOHt\&q=85\&s=65ced73e383c9111af83ea500b1a78d5)

An active guided selling stays checked: if a later change makes it invalid, Qwoty deactivates it and tells you in the builder.

> [!NOTE]
>
> A product without a price in the pricebook isn't blocking: it shows at 0 with the warning "Missing pricebook price". Archived products, products outside the catalog and products of the wrong billing type are hidden from the journey. A **Products** section only accepts one-off products, and a **Subscription** phase only recurring products.

## Use it on a quote

**1. Create the quote**

Click **New quote**, choose the customer, then in **Template** choose the entry named **Template - Guided Selling**, for example `France SMB - Workstation`. The catalog is set to the journey's catalog, and only its pricebooks are offered.

![New project window: each template is followed by its guided sellings](https://mintcdn.com/qwoty-45352a33/5Fg9IpXmttZnaOHt/images/app/guided-selling-new-quote.jpg?fit=max\&auto=format\&n=5Fg9IpXmttZnaOHt\&q=85\&s=28e04da8353486c2972718b178b64142)

A guided selling is offered only if it's active, its **Quote** channel is on, and its catalog and at least one of its pricebooks are available to the customer.

**2. Answer the journey**

The journey opens as soon as the quote opens, before the quote itself. The first time, it's mandatory: it can't be closed until the rep clicks **Validate**.

![Journey window with its summary](https://mintcdn.com/qwoty-45352a33/5Fg9IpXmttZnaOHt/images/app/guided-selling-run-summary.jpg?fit=max\&auto=format\&n=5Fg9IpXmttZnaOHt\&q=85\&s=81b3481e2762a0a8a2cc453d0400895e)

**Validate** is available on the last step, once every visible step is complete. The sections and lines are added after the existing ones, and the message "The journey lines were added to the quote." appears.

**3. Save the quote**

Click **Save**. Until the quote is saved with lines from the journey, the journey opens again each time the quote is opened.

### Run the journey again

To change the answers, click the **Guided selling** button at the bottom of the quote. The journey starts from scratch: answers are never kept. When you click **Validate**, Qwoty asks **Replace the previous journey?**: the lines of the previous journey are removed, including any you edited by hand, then replaced. Lines you added manually are kept.

### Good to know

* Prices are inserted as manual prices: changing the quote's pricebook afterwards doesn't change them.
* The guided selling chosen at creation can't be changed on the quote. In the quote settings, only its catalog and pricebooks are offered.
* If you change the quote's pricebook, save the quote before running the journey again.
* The **Guided selling** button disappears if the guided selling is deactivated or deleted, or if your subscription no longer includes it. Lines already added stay on the quote.

## Related

> [card] [Guided selling reference](https://docs.qwoty.io/user-guide/templates/reference/guided-selling.md)
>
> Structure, rules, formulas, pricing and activation checks in detail.

> [card] [Create a quote template](https://docs.qwoty.io/user-guide/templates/how-tos/create-quote-template.md)
>
> Catalogs, pricebooks and terms of a template.

> [card] [Product configurator](https://docs.qwoty.io/user-guide/catalog/how-tos/product-configurator.md)
>
> Configured products used in a journey.


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