> For the complete documentation index, see [llms.txt](https://docs-shpf.bsscommerce.com/bss-b2b-quick-order-and-quotes/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs-shpf.bsscommerce.com/bss-b2b-quick-order-and-quotes/getting-started/quick-start-5-10-mins-setup.md).

# 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&amp;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&amp;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&amp;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&amp;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&amp;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.

<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&amp;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%2F4o5wICjMOKm4GFzV2xLt%2Fimage.png?alt=media&amp;token=b77b44f2-807f-460a-9701-cc746129073a" 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%2FiZYnAhOKu5KndXjUx8z6%2Fimage.png?alt=media&amp;token=75810942-b11b-4fb1-980b-aefbdce0aafb" 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&amp;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&amp;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&amp;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&amp;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&amp;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&amp;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&amp;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%2FIakD3i0yp73z7KP6VoFX%2Fimage.png?alt=media&amp;token=bbf27e0b-cabc-4bb2-934f-8e7f6c29f8e8" 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&amp;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&amp;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&amp;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%2FLU5ccl7P4WoKnZ5DU4oR%2Fimage.png?alt=media&amp;token=cb85adf7-9882-43b0-86d8-a7665cb131e8" 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&amp;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%2F3Vc6XLNnVUQ5HUAikDRA%2Fimage.png?alt=media&amp;token=b881e248-5b28-476c-b045-40afdf396e62" 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&amp;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&amp;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&amp;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&amp;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 %}

***
