# Quick Start (5–10 mins setup)

This Quick Start guide helps you get the app working on your storefront in just a few minutes.\
You’ll:\
• Embed the app on your theme\
• Create your first Quick Order page\
• Create your first basic Quote Logic

────────────────────

## Step 1: Embed the App on Your Theme

1. Go to the app dashboard and click **“Action required - App is not set up on your store."** > Click **Embed app**

<figure><img src="https://165668525-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6BtZ1bmXof30clbYP14n%2Fuploads%2FbCcPv7bAfPwI1jo06Civ%2Fimage.png?alt=media&#x26;token=1537e167-4399-414b-9294-776e3277aba9" alt=""><figcaption><p>click <strong>“Action required - App is not set up on your store"</strong></p></figcaption></figure>

<figure><img src="https://165668525-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6BtZ1bmXof30clbYP14n%2Fuploads%2FCt2ur5n1ZuEIDQFEBXs9%2Fimage.png?alt=media&#x26;token=e8170df2-09eb-4ff6-81a3-38145c16ceb3" alt=""><figcaption><p>Click <strong>Embed theme</strong></p></figcaption></figure>

2. On the left sidebar, ensure the app embed switch to **ON,** and click **Save**.

<figure><img src="https://165668525-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6BtZ1bmXof30clbYP14n%2Fuploads%2FOz7NuywEUtrxWlaDT5jD%2Fimage.png?alt=media&#x26;token=5fda7b7f-63eb-4d20-b5ec-baf83a0569f8" alt=""><figcaption><p>Click <strong>Save</strong></p></figcaption></figure>

3. Return to the dashboard. You’ll see a confirmation that the app is embedded successfully.

***

## Step 2: Create a Quick Order Page

{% hint style="warning" %}
[**Skip**](#step-3-create-a-quote-logic) this step if you only want to use the **Request for Quote** feature.
{% endhint %}

### **2.1. Create a New Page**

* In the app, click “Quick Order” in the navigation/menu bar.
* Under “Create and edit Quick Order pages”, click “Configure” → “Create new page”.

<figure><img src="https://165668525-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6BtZ1bmXof30clbYP14n%2Fuploads%2FeASIx60LhtgwGl2YHLAi%2Fimage.png?alt=media&#x26;token=e8adaa71-c31f-4e7d-aa9c-477dd3069530" alt=""><figcaption></figcaption></figure>

<figure><img src="https://165668525-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6BtZ1bmXof30clbYP14n%2Fuploads%2FWnE10N80DD6WSVjYvkGG%2Fimage.png?alt=media&#x26;token=4004bd29-5cdf-4bac-8424-25516fb70ead" alt=""><figcaption><p>Click <strong>Create new page</strong></p></figcaption></figure>

### 2.2. Choose Type of Store (Shopify Plus Only)

• If you’re on Shopify Plus using Shopify B2B:

– A modal will appear asking you to choose:\
• Default Store\
• B2B Store\
– Select the option that matches the store you want to configure, then click “Create Page”.

• If you’re not on Shopify Plus:

– This modal won’t appear; you’ll go straight to setting up the Default Store.&#x20;

<figure><img src="https://165668525-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6BtZ1bmXof30clbYP14n%2Fuploads%2FLGL4sRB3y5fdoqg2qJKC%2Fimage.png?alt=media&#x26;token=859ebc56-9850-4851-bca6-0f01ced1861f" alt=""><figcaption></figcaption></figure>

Once selected, you’ll enter a setup modal with **3 tabs** at the top:

* **Set Up Quick Order Visibility**
* **Customize Quick Order Page**

You'll start with the first tab: **Set Up Quick Order Visibility**

### **2.3. Set Up Quick Order Visibility**

In this tab, define who can see this page and what products appear:

<figure><img src="https://165668525-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6BtZ1bmXof30clbYP14n%2Fuploads%2FCvXD7RPmkyuLnvk0nqLJ%2Fimage.png?alt=media&#x26;token=a2171459-4060-4091-86ea-4f00abe9c214" alt=""><figcaption></figcaption></figure>

You should:

• Enter a clear Page Name

– Example: “Wholesale Quick Order” or “B2B Essentials”.

• Select which customers can view the page

– All customers\
– Only logged-in customers\
– Specific tags/groups (e.g., “wholesale”, “dealer”)

• Choose which products to display

– All products\
– Certain collections\
– Specific products or product types

When done, click the next tab: “Customize Quick Order Page”.

### **2.4. Customize Quick Order Page**

In this tab, you control the layout and information shown on the Quick Order page:

You can:

* Show/hide elements (Page description, search bar, filters, etc.)
* Choose which product details appear in the table:  SKU, Type, stock, Discount badge…
* Align styling with your brand (labels, button text, basic colors if available in settings)

<figure><img src="https://165668525-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6BtZ1bmXof30clbYP14n%2Fuploads%2Fr95cVCnyjnwjGM2p0hAD%2Fimage.png?alt=media&#x26;token=eddab099-7f26-4ab9-bc5b-3b76db10fea9" alt=""><figcaption></figcaption></figure>

Once you’re satisfied:

• Click “Save”\
• Close the setup modal.

<figure><img src="https://165668525-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6BtZ1bmXof30clbYP14n%2Fuploads%2FbsEXbnCsasrwFxHckzSW%2Fimage.png?alt=media&#x26;token=0f0088c8-5f9b-442d-8223-10162a4135a4" alt=""><figcaption><p>Click <strong>Save</strong></p></figcaption></figure>

<figure><img src="https://165668525-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6BtZ1bmXof30clbYP14n%2Fuploads%2FAyfuCac7rdXE8LlapRTL%2Fimage.png?alt=media&#x26;token=7ab0e790-7a79-4ee8-9c9e-4cd346ee80a5" alt=""><figcaption><p>Close the <strong>Modal</strong></p></figcaption></figure>

### **2.5. Publish Your Page**

* Click **Publish**, enter a **page title** and **handle**, then click **Publish** again.

<figure><img src="https://165668525-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6BtZ1bmXof30clbYP14n%2Fuploads%2FU4a0ieVPeZVOasB5BOxM%2Fimage.png?alt=media&#x26;token=299781a1-1ee1-48ec-8f6e-14d1a191d194" alt=""><figcaption><p>Click <strong>Publish</strong></p></figcaption></figure>

<figure><img src="https://165668525-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6BtZ1bmXof30clbYP14n%2Fuploads%2FF04svJGlJCFaWY3zbzfE%2Fimage.png?alt=media&#x26;token=710dfbbe-097c-4419-aae1-7291817f8716" alt=""><figcaption><p>Enter Page Title and URL > <strong>Publish</strong></p></figcaption></figure>

* Click **View** to see your live Quick Order page.

<figure><img src="https://165668525-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6BtZ1bmXof30clbYP14n%2Fuploads%2FbIn4DKvTQK30A9JXjbyk%2Fimage.png?alt=media&#x26;token=40a94d75-78c7-48bc-acfa-6e0a413f1060" alt=""><figcaption><p>Click <strong>View</strong></p></figcaption></figure>

<figure><img src="https://165668525-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6BtZ1bmXof30clbYP14n%2Fuploads%2F9fL4vJOYTXLzzun6DN2M%2Fimage.png?alt=media&#x26;token=effc9eaa-03ed-4459-b73f-76b9263732ff" alt=""><figcaption><p>Quick Order Page is now visible on your storefront! 🚀</p></figcaption></figure>

***

## **Step 3: Create Quote Logic**

{% hint style="success" %}
**Note:** You can follow this quick guide or refer to the **“Basic Setup Guide”** page for a more detailed walkthrough of this module.
{% endhint %}

{% hint style="warning" %}
**Note:** If you only want to use the **Request for Quote** module without setting up quote logic, feel free to skip this step.
{% endhint %}

### **3.1. Open The Quote Logic Configuration**

Click **Request for Quote** in the navigation bar. In the **Quote Logic** section, click **Manage** → then click **Create new logic**

<figure><img src="https://165668525-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6BtZ1bmXof30clbYP14n%2Fuploads%2Ft2vXSwNkrW7rUaXp4S0o%2Fimage.png?alt=media&#x26;token=0f3aca3a-eac4-4c57-b640-e825f939576b" alt=""><figcaption><p>Click <strong>Request for Quote</strong> in the navigation bar</p></figcaption></figure>

<figure><img src="https://165668525-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6BtZ1bmXof30clbYP14n%2Fuploads%2Fx1EZkwph1EguNwqUSztY%2Fimage.png?alt=media&#x26;token=57a07452-30ce-49e7-9994-3d9a2b770623" alt=""><figcaption><p>click <strong>Manage</strong></p></figcaption></figure>

<figure><img src="https://165668525-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6BtZ1bmXof30clbYP14n%2Fuploads%2FWB3uQuHuv2OFMYa2jBXc%2Fimage.png?alt=media&#x26;token=9077876f-9a6d-41a0-9db5-2b6a804db1b9" alt=""><figcaption></figcaption></figure>

### **3.2. Choose Store/Customer**

After clicking **Create new logic**, a modal will appear asking you to select a store type:

* **Default**
* **B2B** (available on **Shopify Plus**)

{% hint style="warning" %}
If you’re **not on a Shopify Plus plan**, this modal won’t appear, you’ll be taken straight to set up the **Default Store**.
{% endhint %}

<figure><img src="https://165668525-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6BtZ1bmXof30clbYP14n%2Fuploads%2FGLUpF3sPseScRtXiWuyp%2Fimage.png?alt=media&#x26;token=50209b47-0800-4291-9c65-dc25585bfa3c" alt=""><figcaption></figcaption></figure>

Once selected, you’ll enter a setup modal with **3 tabs** at the top:

* **Set Up Quote Visibility**
* **Set Up Prices & Buttons**
* **Customize Quote Form**

You'll start with the first tab: **Set Up Quote Visibility**.

### **3.3. Set Up Quote Visibility**

In this tab: You must enter a **name** for your quote logic, (Optional) Set a **priority,** Choose which **customers** will see the quote form, Select **products** where the quote button and form will be shown.

<figure><img src="https://165668525-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6BtZ1bmXof30clbYP14n%2Fuploads%2FSaNhvmTcN7t4F8BJ4E5j%2Fimage.png?alt=media&#x26;token=3289b83e-6c50-487a-8a28-79e5b49f34c7" alt=""><figcaption></figcaption></figure>

Click the next tab: **Set Up Prices & Buttons**.

### **3.4. Set Up Prices & Buttons**

In this tab: You must choose whether to **show or hide prices,** Customize the appearance of the **quote button** (text, color, etc.).

<figure><img src="https://165668525-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6BtZ1bmXof30clbYP14n%2Fuploads%2FWdk9xJi5VzCLI9J6hr6v%2Fimage.png?alt=media&#x26;token=c6201e8f-084f-4d91-94a0-46e1163cfda4" alt=""><figcaption><p>Show/hide price, buttons</p></figcaption></figure>

<figure><img src="https://165668525-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6BtZ1bmXof30clbYP14n%2Fuploads%2FNz0akUIKxflXUxMKVuJR%2Fimage.png?alt=media&#x26;token=14c73e4f-b604-411c-80ab-96802db0a4b0" alt=""><figcaption></figcaption></figure>

Click the next tab: **Customize Quote Form**.

### **3.5. Customize Quote Form**

In this tab: You can show or hide **product information** on the form. Add, edit, or remove **form fields, c**ustomize the **form design** to match your brand.

<figure><img src="https://165668525-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6BtZ1bmXof30clbYP14n%2Fuploads%2Fgr5kCqE76aF5fv2ThXrj%2Fimage.png?alt=media&#x26;token=30fb68e1-3d72-4885-9cd0-86b1818789c3" alt=""><figcaption><p>Show or hide <strong>product information</strong></p></figcaption></figure>

<figure><img src="https://165668525-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6BtZ1bmXof30clbYP14n%2Fuploads%2Fy1mtEqLTpSvOLWS2EE4M%2Fimage.png?alt=media&#x26;token=37e36785-1487-4b62-ad9f-18f3c12e2dab" alt=""><figcaption></figcaption></figure>

Once everything is set up, click **“Save”** and then close the modal using the **X** button.

<figure><img src="https://165668525-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6BtZ1bmXof30clbYP14n%2Fuploads%2FojQRHvsNZzjGZGa3MIao%2Fimage.png?alt=media&#x26;token=39ba5cab-3a60-452a-bb6c-92fe9e127ca0" alt=""><figcaption><p>Click <strong>Save</strong></p></figcaption></figure>

<figure><img src="https://165668525-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6BtZ1bmXof30clbYP14n%2Fuploads%2FMCzBSPin4gqDQ6n4XZBo%2Fimage.png?alt=media&#x26;token=d7b15810-ffb4-4140-be0f-e6ec6445ed50" alt=""><figcaption><p>Close the modal</p></figcaption></figure>

### **3.6. Preview Your Store**

Open your storefront and test the quote form! Try submitting a quote request to confirm it appears in your **Quote Submission List**.

<figure><img src="https://165668525-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6BtZ1bmXof30clbYP14n%2Fuploads%2F27ZulQYwVSsks5CucgjH%2Fimage.png?alt=media&#x26;token=9eba835c-1b10-402d-b67c-b45dbea74abd" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
***Note:*** We may need to add some code snippets on your Shopify theme to enable the quote button.

If you don’t see the quote form or button on your storefront, please **contact our support team** and we’ll help integrate it with your theme.
{% endhint %}

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs-shpf.bsscommerce.com/bss-b2b-quick-order-and-quotes/getting-started/quick-start-5-10-mins-setup.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
