Documentation

Getting Started with AddToQuote

Learn how to install, configure, and get the most out of your B2B quote management system.

Installation

1
Visit the Shopify App Store

Go to apps.shopify.com/add-to-quote or search for "Add to Quote" in the Shopify App Store.

2
Click 'Install' and authorize

Click the "Install" button. You'll see the screen below asking for permissions. Click Install to continue.

Shopify install authorization dialog for Add to Quote app

The app requires permissions to access your products, create draft orders, and manage theme customizations.

3
Start your 14-day free trial

After installation, you automatically start a 14-day free trial with full access to all features. No credit card required. You'll see the trial banner at the top of the app.

Dashboard Overview

Your dashboard shows how your quoting is performing at a glance. Numbers update automatically as quotes move through stages.

KPIs, Charts & Pipeline Funnel

Dashboard showing Close Rate, Avg Deal Size, Revenue, Conversion Rate, Wins, Lost, Quotes by Month chart, and Pipeline Funnel
Top Row KPIs:
  • Close Rate
  • Average Deal Size
  • Total Revenue
  • Conversion Rate, Wins, Lost
Charts:
  • Quotes by Month (line chart)
  • Pipeline Funnel (New → Won)

Top Products, Salespeople, Customers & Pipeline Summary

Dashboard showing Top Products, Top Salespeople, Top Customers tables, and Pipeline Summary with Pipeline Value, Open Deals, Draft Orders, and Forecast Revenue
Leaderboard Tables:
  • Top Products (SKU, Qty, Volume)
  • Top Salespeople (Deals, Won, Revenue)
  • Top Customers (Quotes, Avg Qty, Volume)
Pipeline Summary:
  • Pipeline Value
  • Open Deals
  • Draft Orders Created
  • Forecast Revenue

All tables have an Export button to download data as CSV or Excel.

Display & Logic

The Display & Logic tab is the first settings tab. All visual settings are configured in the Shopify Theme Editor — this tab tells you where to find them.

Display & Logic settings tab showing store-wide mode and Theme Editor configuration instructions
App Embeds → Add to Quote App Embed
  • Hide ALL prices store-wide
  • Hide cart icon from header
  • Hide Add to Cart buttons
Product Page → Add to Quote Button
  • Button text
  • Button colors (background & text)
  • Button style (shape, width, height)

Store-Wide Mode: The "Add to Quote" button appears on all products automatically. No need to enable specific products or collections.

Quote Settings

Configure your quote numbering format.

Quote Settings tab showing Quote Number Format, Number Length, and Preview
Quote Number Format: Use variables like {{year}}, {{month}}, {{day}}, {{number}}, {{shop}} to create your format (e.g. QT-2026-0001)
Number Length: How many digits to pad (3–8). Default is 4 (e.g. 0001)

PDF Settings

Customize the appearance of generated quote PDFs with your company branding.

PDF Settings tab showing Company Name, Logo upload area, and Logo URL fields
Company Name: Displayed at the top of the PDF. Falls back to your shop name if empty.
Logo: Drag-and-drop upload or enter a URL manually. Accepts PNG, JPG, GIF (max 2MB). Recommended size: 300x100 pixels.

Tip: Upload your logo to Shopify Files (Settings → Files) to get a permanent URL.

Notifications & Team

Set up where you get notified about new quotes and manage your sales team.

Notifications & Team tab showing Notification Email Address, customer confirmation checkbox, and Add Team Member form with Name, Email, Phone fields
Notification Email: Where new quote alerts are sent.
Customer Confirmation: Automatically email customers when they submit a quote.
Sales Team: Add members with name, email, and phone. Leads are assigned in round-robin rotation from #1 to last.

Lead Assignment Priority: Team members are assigned leads in order from #1 to last using round-robin rotation. Use the arrows to change priority.

Email Provider

Emails work out of the box with no setup. Want to send from your own email address? Connect Gmail or Outlook with one click — no API keys needed.

Recommended: Connect your Gmail or Outlook account to send quotes from your own email address. Customers see your email, not ours.

One-Click Email Setup

Google
Google Gmail
  • Click "Connect Gmail"
  • Sign in with Google
  • Done — quotes sent from your Gmail
Microsoft
Microsoft Outlook 365
  • Click "Connect Outlook"
  • Sign in with Microsoft
  • Done — quotes sent from your Outlook

Gmail Setup Guide

  1. Go to Settings → Email Provider in your AddToQuote dashboard
  2. Under One-Click Email Setup, click the "Connect Gmail" button
  3. A Google sign-in window opens — select or sign in with the Gmail account you want to send from
  4. Grant AddToQuote permission to send emails on your behalf
  5. You're redirected back to the app with a "Gmail Connected" confirmation
  6. All quote emails now come from your Gmail address

Outlook 365 Setup Guide

  1. Go to Settings → Email Provider in your AddToQuote dashboard
  2. Under One-Click Email Setup, click the "Connect Outlook" button
  3. A Microsoft sign-in window opens — sign in with your Microsoft 365 or Outlook.com account
  4. Grant AddToQuote permission to send emails on your behalf
  5. You're redirected back to the app with an "Outlook Connected" confirmation
  6. All quote emails now come from your Outlook address

One provider at a time: You can only connect Gmail OR Outlook, not both. To switch providers, disconnect the current one first using the "Disconnect" button, then connect the other.

Other Options

Default (App built-in): Emails sent via AWS SES with no configuration needed. Great for getting started.
API Providers: For advanced users — SendGrid, Resend, or Mailgun with your own API keys.
Test Email: Send a test email to verify your configuration before going live.

Custom CSS

Override default styles for quote buttons, forms, and cart elements with your own CSS. Applied to all quote-related elements on your storefront.

Custom CSS tab showing a code editor textarea for custom CSS with a warning about improper CSS breaking storefront layout

Advanced Feature: Improper CSS can break your storefront layout. Use with caution and test thoroughly after saving.

Form Builder

Choose which fields appear on your quote request form. Turn fields on or off, mark them as required, and see a live preview.

Form Builder showing field configuration on the left (Customer Name, Email Address, Phone Number, Company Name, Street Address, City, State, Postal Code, Country) with ON/OFF toggles and a Live Preview of the form on the right
Available Fields:
  • Customer Name (system, always visible)
  • Email Address (system, always visible)
  • Phone Number
  • Company Name
  • Street Address, City, State, Zip, Country
  • Message/Notes
  • File Attachments
Configuration:
  • Toggle each field ON or OFF
  • Mark fields as required
  • Reorder fields
  • Live preview updates instantly
  • File uploads (when enabled)

Form fields load automatically from your Form Builder settings. No extra configuration needed.

Custom Product Fields

Add custom input fields to product pages so customers can provide item-specific details like engraving text, color preferences, or delivery notes.

How it works:
  • Drag the Custom Fields Widget block onto any product page section in the Theme Editor
  • Configure up to 5 fields per block — set the label, type, and whether it's required
  • Customers fill in the fields, then click Add to Quote — the data flows through the entire pipeline
Supported field types:
Text input
Text area (multi-line)
Dropdown select
Checkbox
Checkbox group (multiple selections)
Radio buttons
Date picker

Custom field data appears everywhere: quote popup, cart, submission form, quote detail page, PDF, emails, draft order line items, Shopify Flow triggers, and outbound webhooks.

Quotes Page

View and manage all quote requests. Filter by pipeline stage, download quotes, or delete them.

Quotes Page showing Quote Overview with counts per stage (New, Qualified, Proposition, Quoted, Won, Lost), filter tabs, and a quote list with Quote number, Customer, Email, Items, Value, Submitted date, Download and Delete actions
Quote Overview: Summary cards showing count per stage (New, Qualified, Proposition, Quoted, Won, Lost)
Filter Tabs: Quick filter by All Quotes, New, Qualified, Proposition, Quoted, Won, Lost
Quote Table: Quote #, Customer, Email, Items, Value, Submitted date
Actions: Download (PDF, CSV, Excel) and Delete per quote

CRM Pipeline

Drag-and-drop board to track every quote from first contact to closed deal.

CRM Pipeline page showing KPIs (Total Pipeline Value, Total Deals, Won This Month, Conversion Rate), Pipeline Distribution bar chart, and Kanban board with columns for New, Qualified, Proposition, Quoted, Won, and Lost stages with lead cards showing deal value, priority, and star rating
Pipeline KPIs:
  • Total Pipeline Value
  • Total Deals
  • Won This Month
  • Conversion Rate
Kanban Features:
  • 6 stages: New, Qualified, Proposition, Quoted, Won, Lost
  • Drag-and-drop leads between stages
  • Star rating and priority badges
  • Pipeline Distribution chart
  • Search leads and export data

Quote Detail & Actions

Click any lead card in the pipeline to see the full details. From here you can manage the deal, convert it to a Shopify draft order, and track everything.

Quote detail modal showing Assigned To dropdown, Shipping Address, Deal Information (Value, Probability, Stage, Priority, Status), Invoice Created banner with View Invoice and Copy URL buttons, and Quote Items table with product image, variant, quantity, price, and total
Assigned To: Assign the lead to a sales team member
Shipping Address: View or edit the customer's shipping address
Deal Information: Value, Probability, Stage, Priority, and Status at a glance
Convert to Draft Order: Creates a Shopify draft order with line items, customer info, and discounts pre-filled. View Invoice and Copy URL buttons appear after conversion.
Quote Items: Full table with product image, variant, quantity, price, and total. Editable.
SKU & Barcode: Each line item displays SKU and barcode when available. This data also flows into emails, PDF quotes, and draft orders.

Draft Orders & Invoicing

Convert approved quotes into Shopify draft orders and send invoices to customers for payment — all without leaving the app.

How to Convert a Quote to a Draft Order

  1. Open a quote from the Quotes Page or CRM Pipeline
  2. Review the quote items, customer info, and deal value
  3. Click the "Create Draft Order" button
  4. The app creates a Shopify draft order with all line items, quantities, customer email, and negotiated prices pre-filled
  5. A green "Invoice Created" banner appears with two buttons: View Invoice and Copy URL

Sending an Invoice

Send Invoice: After the draft order is created, click "Send Invoice" to email the invoice directly to the customer via Shopify.
Copy Checkout URL: Copy the checkout URL to share it manually via chat, SMS, or any other channel.
View in Shopify: Click "View Invoice" to open the draft order in your Shopify admin for further editing.

Validation: If the customer email is missing or invalid, the app will show a specific error message instead of a generic failure. Fix the email in the quote detail before retrying.

Exports (CSV, Excel, PDF)

Export your quote data in multiple formats for external analysis, reporting, or record-keeping.

CSV Export

Standard comma-separated values file. Opens in Excel, Google Sheets, or any spreadsheet tool. Includes all quote fields.

Excel / TSV Export

Tab-separated values file compatible with Microsoft Excel. Preserves formatting for easy data analysis.

PDF Export

Styled PDF with a formatted table. Includes your company logo and branding from PDF Settings.

Where to Export

Quotes Page: Each quote row has a Download button with format options (PDF, CSV, Excel).
Dashboard: Leaderboard tables (Top Products, Top Salespeople, Top Customers) each have an Export button.
CRM Pipeline: Export pipeline data for external reporting or team reviews.

Branded PDFs: Make sure to upload your company logo in PDF Settings before exporting. Your logo and company name appear on every PDF quote.

Shopify Flow

Automate your quote workflow with Shopify Flow. AddToQuote provides 7 triggers and 4 actions that let you build powerful automations without writing any code.

Advanced Plan: Shopify Flow triggers and actions require the Advanced plan ($200/month). Trial merchants have full access to all features.

Requirement: Shopify Flow is available on Shopify Plus, or any plan that includes Flow (most current Shopify plans include it).

7 Triggers

Triggers fire automatically when something happens in AddToQuote. Use them to start Flow workflows.

Shopify Flow trigger picker showing all 7 AddToQuote triggers: Quote Requested, Quote Stage Changed, Quote Converted, Quote Assigned, Quote Note Added, Quote Deleted, Invoice Sent

Quote Requested

Fires when a customer submits a quote. Includes 15 data fields: items, customer info, address, and message.

Quote Stage Changed

Fires when a quote moves between pipeline stages. Includes old stage and new stage.

Quote Converted

Fires when a quote is converted to a draft order. Includes draft order GID and customer reference.

Quote Assigned

Fires when a quote is assigned to a team member. Includes team member name and email.

Quote Note Added

Fires when a note is added to a quote. Includes the note content.

Quote Deleted

Fires when a quote is deleted. Includes the quote ID and number.

Invoice Sent

Fires when a draft order invoice is sent. Includes the draft order ID and customer email.

4 Actions

Actions let Shopify Flow perform operations in AddToQuote as part of a workflow.

Shopify Flow action picker showing all 4 AddToQuote actions: Convert Quote to Draft Order, Update Quote Pipeline Stage, Assign Quote to Team Member, Add Note to Quote

Convert Quote to Draft Order

Creates a Shopify draft order from a quote. Idempotent — safe to run multiple times. Optional flag to send the invoice automatically.

Update Quote Pipeline Stage

Moves a quote to any valid pipeline stage (New, Qualified, Proposition, Quoted, Won, Lost).

Assign Quote to Team Member

Assigns a quote to a specific team member by their ID.

Add Note to Quote

Appends a note to the quote. Notes added via Flow are prefixed with [Flow] and never overwrite existing notes.

Example Workflows

Shopify Flow workflow example showing a multi-step automation with AddToQuote triggers and actions
Auto-Convert High-Value Quotes

When a quote stage changes to "Won", automatically convert it to a draft order and send the invoice.

Auto-Assign by Region

When a quote is requested, check the shipping region and assign it to the right sales rep automatically.

Follow-Up on Lost Quotes

When a quote moves to "Lost", send a follow-up email to the customer or notify the sales team.

Known Limitation: Shopify Flow's "Get data → For each → Add tags" pattern does not work with third-party triggers. Use the customer_reference on the Quote Converted trigger for customer tagging workflows.

Messaging Notifications

Get instant notifications in your team chat when quotes are submitted, stages change, or deals are won. Connect to Slack, Discord, Microsoft Teams, or Telegram with one click.

Advanced Plan: Messaging notifications require the Advanced plan ($200/month). Trial merchants have full access to all features.

#
Slack

Post notifications to any channel when quotes are submitted, converted, or moved between stages.

D
Discord

Send rich embeds to Discord channels with quote details, customer info, and deal values.

T
Microsoft Teams

Notify your sales team in Teams channels when new quotes arrive or deals close.

Telegram

Get instant mobile alerts via Telegram when quotes need attention or action.

Configure messaging integrations in Settings → Integrations. Each platform supports multiple channels and custom notification rules.

Product Options

Create per-product custom options that customers fill out when requesting a quote. Build option sets with drag-and-drop and assign them to specific products.

Enterprise Plan: Product Options require the Enterprise plan ($300/month). Trial merchants have full access to all features.

12 Field Types

Text
Textarea
Number
Dropdown
Checkbox
Checkbox Group
Radio
Date
Color Swatch
Image Swatch
File Upload
Toggle

Admin UI

Build option sets with a drag-and-drop field builder in the AddToQuote admin. Assign option sets to specific products using Shopify's ResourcePicker. Option data is synced to product metafields for storefront rendering.

Theme Block

Add the "Product Options Widget" block to your product template in the Theme Editor. The block renders the assigned option set fields automatically on the storefront.

Product option values are captured as line item properties and flow through the full pipeline: quote submission, CRM, PDF generation, emails, draft orders, Flow triggers, and outbound webhooks.

Outbound Webhooks

Send real-time quote data to any external system via HMAC-signed webhooks. Connect AddToQuote to your CRM, ERP, Slack, Zapier, or any service that accepts HTTP POST requests.

Advanced Plan: Outbound webhooks require the Advanced plan ($200/month). Trial merchants have full access to all features.

No Shopify Plus required. Outbound webhooks work on any Shopify plan.

Setup

Settings Integrations tab showing the webhook endpoint creation form with URL field, event selection checkboxes, and secret key
1
Go to Settings → Integrations

Open the Integrations tab (tab 7) in your AddToQuote settings.

2
Click 'Add Endpoint'

Enter your HTTPS endpoint URL. Only HTTPS URLs are accepted for security.

3
Select events to receive

Choose which events this endpoint should receive. You can select all or pick specific ones.

4
Test your endpoint

Click "Test" to send a sample quote.test event to verify your endpoint is reachable.

5
Enable the endpoint

Toggle the endpoint on. You can pause and re-enable at any time.

8 Webhook Events

quote.created

A new quote request is submitted

quote.stage_changed

A quote moves between pipeline stages

quote.converted

A quote is converted to a draft order

quote.assigned

A quote is assigned to a team member

quote.note_added

A note is added to a quote

quote.invoice_sent

A draft order invoice is sent

quote.deleted

A quote is deleted

quote.test

Test event sent when you click "Test"

Delivery Logs

Webhook delivery logs showing timestamps, HTTP status codes, response times, and event types for each delivery attempt

Every delivery is logged with the HTTP status code, response time, and event type. Use delivery logs to debug integration issues.

Security Features

HMAC-SHA256 Signature: Every webhook payload is signed. Verify using the X-AddToQuote-Signature header.
HTTPS Only: Endpoints must use HTTPS. HTTP URLs are rejected.
SSRF Protection: Private and internal IP addresses are blocked to prevent server-side request forgery.
Automatic Retries: Failed deliveries are retried up to 3 times with exponential backoff.
Webhook test success showing a green checkmark with the test event delivered successfully to the configured endpoint

Limit: Up to 5 webhook endpoints per store. Each endpoint can subscribe to different events.

Theme Editor Setup

Enable App Blocks in Your Theme

1
Open Theme Editor

Go to Online Store → Themes → Customize in your Shopify admin.

2
Enable the App Embed

Click App embeds at the bottom of the left sidebar. Toggle on Add to Quote App Embed. This controls cart icon hiding, Add to Cart hiding, and the quote header icon.

3
Enable the Popup Widget

Still in App embeds, toggle on Add to Quote Popup Widget. This adds a floating quote button to every page so customers can view and submit quotes without navigating away.

4
Add the Button Block to Product Pages

Navigate to a product page template. Click Add block in the product section and select Add to Quote Button. This is where you configure button styling and price hiding.

Theme Editor showing Add to Quote Button block selected in Product information section with Button Text, Button Colors, Button Style, and Price Hiding settings on the right
5
Add remaining widgets to your theme

Create pages for your quote cart and form. Add these app blocks to the pages:

Add to Quote App Embed

Global embed: hides cart icon, Add to Cart buttons, shows quote header icon

Add to Quote Popup Widget

Floating button + slide-up quote panel on every page

Add to Quote Button

Product page block: quote button + price hiding settings

Quote Icon Widget

Header icon with badge showing item count

Product List Widget

Full-page display for reviewing selected quote items

Quote Form Widget

Quote submission form with your configured fields

Custom Fields Widget

Per-product custom input fields (text, dropdown, checkbox, radio, date)

Product List Widget

Product List Widget in Theme Editor showing selected products with images, prices, quantity controls, and Remove buttons, with layout and styling settings on the right

Quote Form Widget

Quote Form Widget in Theme Editor showing the quote submission form with Full Name, Email, Phone, Company Name, and Message fields, with form layout and color settings on the right

Make sure to save your theme changes and publish if needed.

Price Hiding

Price hiding is configured in two places depending on the scope:

Store-Wide (App Embed)

In App Embeds → Add to Quote App Embed, toggle "Hide ALL prices" to replace every price on your store with "Contact for pricing".

Product Section (Button Block)

In the Add to Quote Button block, toggle price hiding scoped to the product section only. Set custom replacement text and a custom CSS selector for unusual themes.

Popup Widget

In the Popup Widget settings, toggle "Hide prices" to hide prices inside the popup panel and replace with custom text.

How to Enable:

  1. Go to Online Store → Themes → Customize
  2. Navigate to a product page template
  3. Click the Add to Quote Button block
  4. Check "Hide prices in this section"
  5. Optionally set custom replacement text
  6. For unusual themes, paste a custom CSS selector
  7. Save your changes
Auto-detects prices on 20+ Shopify themes (Dawn, Debut, Brooklyn, Prestige, etc.)
Product section scope — never hides shipping, tax, or promo prices
Automatically handles variant price changes

Perfect for B2B: Hide prices to encourage customers to request quotes for bulk or custom pricing.

Need Help?

Can't find what you're looking for? Our support team is here to help.