Documentation Open Ecwid app

Ecwid guide

Setup & storefront

The five Setup pages control merchant identity, quote behavior, customer-facing copy, outbound mail, and assignment. Installation then publishes those settings to the storefront.

Store Profile

  • Company name, support email, phone, fax, and business address.
  • Store website, secure cart URL, tax ID, and business hours.
  • Store currency synchronized from the Ecwid profile and used for new quotes.
  • Company logo used on quotes, emails, PDFs, and branding.

Logo uploads accept PNG, JPG, or GIF files up to 2 MB. The saved public URL follows /cdn/profile/{storeId}/logos/{uuid}.ext.

Basic Setup

  • Enable Quotes — Master switch for the quote system.
  • Hide All Prices / Hide Zero Price — B2B storefront price visibility.
  • Quote Chat — Store-level chat switch when the optional chat deployment is available.
  • Quote Widget — Widget appearance options in admin (current storefront uses the shared Quote2Cart widget).
  • Brand Color — Primary color for quote buttons and branded elements.
  • Default Tax Rate — Initial tax percentage for quotes.
  • Hidden Price Display — Replacement text shown instead of a hidden price.
  • Quote Numbering — Prefix and minimum sequence width.

Customer Interface

Customize storefront button labels and customer messages without editing theme files:

  • Add to Quote button text on product pages.
  • Convert to Quote button text on the cart page.
  • Empty quote message.
  • Submission confirmation headline and body.

Email & SMTP

  • Use the Quote2Cart shared relay or configure a custom SMTP host, port, encryption, user, and password.
  • Send a test message after saving delivery settings.
  • Set subject prefix, new-quote notification recipients, BCC recipients, and reminder delay.
  • Choose an email/PDF presentation: Classic, Modern, Professional, Minimal, Executive, or Horizon.
  • Edit new-quote, confirmation, terms, and reminder copy.

Custom SMTP passwords are stored encrypted; leave the password blank later to keep the saved value.

Quote Distribution

Choose how incoming storefront requests are assigned:

  • Load balanced — Automatically distribute requests across sales reps.
  • Manual — Keep requests unassigned until a manager chooses an owner.

Installation & publish

Ecwid loads the shared Quote2Cart storefront loader from the app’s customJsUrl. The loader obtains the Ecwid owner ID and requests that store’s public widget configuration.

  1. Complete the required Setup checklist.
  2. Open Installation from the Dashboard/Basic Setup publish controls and copy the Loader URL.
  3. Configure the app customJsUrl once in the Ecwid Developer Portal.
  4. Click Publish widget.
  5. Open the storefront and verify Add to Quote, Convert to Quote, and the quote launcher.

Disable widget removes customer quote controls but keeps configuration for a later republish. Publish/disable changes a store setting; it does not generate merchant-specific JS or rewrite customJsUrl.

Customer storefront experience

  • Add products and selected options to a quote from product pages.
  • Convert the current Ecwid cart into a quote request.
  • Review and update quote lines, quantities, and contact details before submission.
  • See My Quotes for quote requests created in the same browser session.
  • Open the checkout link from a sent quote to rebuild the Ecwid cart.
Current storefront notes: widget copy is English-only today; customer-facing chat is not part of the storefront widget; soft publish does not install customJsUrl for you.