Quick Start (5–10 mins setup)
Get BSS B2B Quote up and running on your storefront in a few minutes. You create a quote logic, check the Request a Quote button on your store, send yourself a test quote and look at the emails your buyers get.
The app guides you in two places:
- First-run setup: opens the first time you open the app, in four steps (Your needs, Quick setup, Plan, Demo). A label at the top shows where you are, for example Step 2 of 4.
- Setup guide on Home: Let’s get your first quote button live. It keeps track of what is left and checks each step off when you finish it.
First-run setup
Section titled “First-run setup”- Your needs: choose what you want to start with: Request a quote, Quick order, Reorder or Something else. If you choose Something else, describe what you need. We send your note to our team and they reply in chat. The setup then goes straight to the Demo step.
- Quick setup: for Request a quote, you pick a template and who sees the quote button, the app creates your first quote logic, you turn on the app embed, and you preview the quote button on your store and send a test quote.
- Plan: choose a plan to show the quote button to your buyers. The app suggests a plan for what you built. Click Start free trial & go live. On a development store, click Activate free dev plan. You can also click Stay in preview for now and go live later from Home.
- Demo: book a demo with our team, or click Finish.
Your progress is saved after each step. If you close the app or reload the page, the setup opens at the step you left.
The app embed and preview parts of Quick setup have a skip button (for example I’ll do it later or Skip test). Before you skip, the app tells you what happens. For example, if you skip the app embed, your preview does not show the button until you turn the embed on. If you skip the plan, buyers do not see the quote button until you choose a plan. When it is shown, Skip setup at the bottom of a step, next to Back, lets you leave the setup and finish everything later from Home.
The setup guide on Home
Section titled “The setup guide on Home”On Home, the setup guide has four steps, and the app checks them off as you finish them:
- Choose where the quote button shows: create a quote logic.
- Turn on the app embed.
- Check the quote button on your store.
- Send a test quote.
If your store has no plan yet (preview mode), a fifth step, Go live, asks you to choose a plan. Create a Quick Order page is an optional line at the end and does not count toward the progress.
The steps below follow the same order.

The setup guide on Home

The Needs your attention card on Home
-
Create a quote logic
Section titled “Create a quote logic”A quote logic decides who sees the quote button, on which products, and what happens to the price and Add to cart. You need at least one active quote logic to show the Request a Quote button.
- On Home, click Create quote logic in the setup guide. You can also go to Settings > Quote logic and click Create quote logic.
- If you are in the first-run setup, pick a template instead: Quote for all products, Hide price + quote (hides the price, Add to cart and Buy now, so buyers request a quote) or Quote from cart (a button on the cart page). Then choose Who sees the quote button?: Everyone, Logged-in customers or B2B companies, and click Create quote button.

In the logic editor, a Storefront preview shows the result on the right. At the top of Quote visibility, choose the Customer type:
- Default customers (selected by default)
- Company customers (B2B customers, needs the Enterprise plan of BSS B2B Quote; on other plans it is greyed out with an upgrade link)
The customer type can’t be changed after the quote logic is saved.

Under Quote visibility, enter a name, set the Status, (optional) set a Priority (0 to 99, 0 is the highest), choose who can request a quote, and exclude customers if needed. Under Quote catalogs, choose which products can be quoted.

Click Save to apply the quote logic to your store.
-
Turn on the app embed
Section titled “Turn on the app embed”The app embed loads the quote button and form on your storefront. Without it, nothing from the app shows.
- On Home, in the setup guide, click Open theme editor next to Turn on the app embed.
- The app opens the Shopify theme editor on the app embeds.
- Turn the B2B Portal app embed ON in the left sidebar and click Save in the top-right corner. If the theme editor also lists Quote Engine storefront, you can turn it on too, but keep B2B Portal on. See Install and enable app embeds.
- Return to the app. It checks your live theme and checks off the step.

Turn on the B2B Portal app embed and click Save
The status line under the setup guide on Home shows Nothing to fix and your Live theme once the embed is on. Click Run again to check again.

If another app already uses the app proxy path
/apps/customer-portal, Home shows App proxy doesn’t reach this app with a Check URL button, because quote requests from your storefront may not reach you. Click Check URL to open the Proxy URL steps. See Check the App Proxy URL.
-
Check the Request a Quote button
Section titled “Check the Request a Quote button”Open your store and look at the button as your buyers see it.
- On the quote logic page, click Preview on store. On Home, click Preview on a product in the setup guide. Your store opens in a new tab on a page the logic covers, so you can see the quote button.
- If you don’t see it, click Don’t see the quote button? for a short checklist (app embed, theme, plan, customer, inactive quote logic). In the setup guide, Check this page runs the same check on your live theme and checks off the step when the app embed and the button pass.
- To change the look of the button, the widget or the form, click Customize under the Storefront preview. The Customize quote button and form modal shows your changes in a preview. See Customize the quote form and Customize the quote widget.
- If the button shows but sits in the wrong place, see Button placement and themes.


-
Send a test quote
Section titled “Send a test quote”You can see your quote button and send a test quote before you choose a plan.
- Click Preview on my store (in the first-run setup) or Preview on store (on the quote logic page or in the setup guide). Your store opens in a new tab.
- A banner at the top of the page shows that you are in preview. Click Exit preview to leave the preview. The page reloads without the app.
- Add a product to the quote list and submit the quote form. This is the Send a test quote step of the setup guide. Your test quote shows up in Quotes.

About the preview link:
- It is valid for 24 hours. After that, open Preview on store again.
- It works only in the browser where you opened it. Buyers and other browsers see nothing from the app until you go live. On a store without a plan, only the browser that opened the preview link sees the app.
- If your online store has a password, enter the storefront password first, then open the preview. You need the password only once in the same browser.
- The theme editor preview is for looking only. To send a test quote, use Preview on my store (first-run setup) or Preview on store (quote logic page and setup guide).
About test quotes:
- Test quotes show a Test badge in Quotes.
- The email to you has [TEST] at the start of the subject. Your buyer gets no email.
- Test quotes are not counted in Insights or in the Home statistics.
- A store without a plan can send 5 test quotes in 24 hours, and 10 in total.
- If the quote form is for logged-in customers, such as company customers, log in to your store as that kind of customer first.
-
Check your quote emails
Section titled “Check your quote emails”Quote emails are what your buyers read first: the proposal, the reminders and the approve or reject buttons.
- No time to use your store? In the first-run setup, click Send me a sample quote email to get a sample at your store email. It needs a store email in your Shopify settings.
- Open your test quote in Quotes to see the quote page, where you edit prices and send the proposal.
- Edit the wording and the PDF of the emails, and set reminders. See Quote emails and reminders.
- If you want emails to come from your own domain, see Sender and deliverability.
-
Go live
Section titled “Go live”If your store has no plan yet, buyers see nothing until you choose one.
- On Home, click Choose a plan next to Go live, then start your free trial. On a development store, click Activate free dev plan.
- Compare the plans in Pricing Plan & Details.
Next steps
Section titled “Next steps”- Key concepts and terminology
- Manage your quotes: edit prices, check the margin and send proposals.
- Quote automation: send proposals and approve or reject quotes automatically.
- If something does not show, see Quote button not showing or the Help center.
Optional: Quick Order and Reorder
Section titled “Optional: Quick Order and Reorder”Quick Order and Reorder are extra ordering tools for your buyers. If you want them, see the Quick Order Full Setup Guide and the Reorder Full Setup Guide.
- Help CenterFind step-by-step guides in the app, check why your quote button isn't showing on your storefront, and reach our support team.
- Key Concepts & TerminologyThe core ideas behind BSS B2B Quote: quotes, quote logic, statuses, buyers, companies, price approval, and the ordering tools.
- Pricing Plan & DetailsCompare the Growth, Business and Enterprise plans of BSS B2B Quote: usage limits and the Quick Order, Request for Quote and Reorder features in each.