Ecwid App

The Quote2Cart Ecwid app embeds in your Ecwid Control Panel and loads the storefront quote widget via the app’s custom JavaScript URL. Soft publish in the app turns quotes on for shoppers without rewriting that URL.

Ecwid documentation

Workspace & quotes — Dashboard, quote composer, detail actions, and optional Quote Chat.
Companies & customers — Company directory, customer history, and customer groups.
Setup & storefront — All five Setup pages, Installation, publish, and shopper experience.
Pricing & visibility tools — Automatic Discounts and Hide Add to Quote.
Account & help — Trial status, languages, support, and troubleshooting.

Install the app

From Ecwid App Market

In Ecwid, open Apps → App Market.
Search for Quote2Cart.
Click Get / Install and approve the requested OAuth scopes.
Open the app from My Apps to finish setup.

Tip: Complete Store profile (company name, logo) and Email / SMTP before you publish the widget so customer emails look correct on day one.

Storefront loader (customJsUrl)

Ecwid injects Quote2Cart through your app’s customJsUrl in the Ecwid Developer Portal (configured for the app, not per store theme). The loader resolves your store ID with Ecwid.getOwnerId() (or window.ecwidStoreID), loads versioned quote2cart-init.js, and fetches /api/public/widget-config?storeId=….

Prefer the unique filename quote2cart-ecwid-loader.js so it does not collide with other Ecwid apps that may still use a legacy SearchIQ loader name.

Copy the loader URL from the Installation screen in the Quote2Cart app (opened from the publish controls on Dashboard or Basic Setup; Installation is not a left-menu item). Soft publish does not change customJsUrl — it only flips the live flag for shoppers.

Storefront widget

Open Installation from the widget publish controls (Dashboard or Basic Setup) to Publish or Disable the storefront experience.

Published — Shoppers see Add to Quote, Convert to Quote, and My Quotes when quotes are enabled.
Not published / disabled — Widget stays off; your settings are kept for later.

What shoppers see when live

Add to Quote on product pages (button label configurable).
Convert to Quote on the cart page.
Floating launcher for the current quote and My Quotes.
Quote request form — contact details and submit success messaging from Customer Interface settings.

Hard refresh: After publish, reload the Instant Site with Ctrl+F5 if buttons do not appear immediately (browser cache of the loader/init assets).

Quotes in admin

Use the app sidebar for day-to-day quote work:

Dashboard — Volume and status overview.
Quotes — List, filter, open detail, create or edit quotes.
Customers / companies — B2B account context for quoting.
Quote chat — Negotiate with the customer from the quote thread (when enabled).

Typical statuses: Draft → Sent → Opened (customer opened checkout link) → Completed.

Store profile & logo

Under Settings → Store profile, set company name, address, and the company logo used on quote documents and emails.

Logo uploads are stored under the profile CDN path /cdn/profile/{storeId}/logos/{uuid}.ext and saved as logoUrl on the store profile. Naming uses a UUID plus the original file extension (PNG, JPG, or GIF).

Email & SMTP

Configure outbound email so Sent quotes reach customers with your branding. Use the app’s Email / SMTP settings for from-address, reply-to, and optional custom SMTP.

Send a test email after saving. Quote emails include line items, totals, PDF attachment (when enabled), and the checkout / cart link.

Price and button visibility

Quote2Cart has two separate controls:

Basic Setup — Hide all prices or hide zero-price products, and choose the placeholder text shown instead of a price.
Tools → Hide Add to Quote — Remove the quote button from selected products without hiding those products from the storefront.

See Basic Setup and Hide Add to Quote for details.

Convert to cart

When a quote is sent, the customer receives a link that rebuilds an Ecwid cart with the negotiated lines and prices. They complete checkout with Ecwid’s normal payment methods.

Finalize lines, discounts, tax, and shipping in the quote admin.
Send the quote (email + PDF as configured).
Customer opens the link → Ecwid cart → pays.
Quote status moves to Opened / Completed based on your workflow settings.

Troubleshooting

No quote buttons on the storefront — Confirm Installation shows Published, quotes are enabled in settings, and customJsUrl points at quote2cart-ecwid-loader.js. Hard-refresh the storefront.
Widget published but still inactive — Check that /api/public/widget-config returns enableQuotes: true for your store ID (Ecwid owner ID).
Emails not sending — Verify SMTP / email settings and send a test message.
Logo missing on PDF — Re-upload under Store profile and confirm the public logoUrl loads in a browser.
Collision with SearchIQ Instant Search — Use the Quote2Cart-specific loader filename, not a shared legacy searchiq-ecwid-loader.js URL on SearchIQ CDN hosts.

Plans & billing

Open Payments to review Trial, Active, or Expired status and remaining trial days. Self-service payment processing and plan upgrades are not yet available on this beta screen; contact support to upgrade.

Need help choosing a plan? Contact support@quote2cart.app.