How to Add the Quixo Widget to Your Website

The Quixo widget is the fastest way to turn your website into a quote capture channel. On provider-owned websites, the preferred flow is simple: the customer opens the widget, submits their request, and the lead routes directly to your business instead of being pushed into the broader marketplace by default.

Why the widget matters

Most service businesses already have traffic coming to a contact page, a booking page, or a "request a quote" page. The problem is that a generic contact form often creates slow back-and-forth. The Quixo widget asks for the right context up front so the request enters your workflow in a more useful shape.

What you need before you start

• You should be signed in as the company owner in SendQuote.
• Your company name and brand color should already be set in the app.
• You need access to the website template or CMS area where you can paste a script snippet.
• You should have one live page where you can run a real test after installation.

Where to generate the code in Quixo

1. Log in to SendQuote as the company owner.
2. Open Desktop Settings.
3. Go to the Incoming Leads section.
4. Open the Website Widget panel.
5. Generate a new widget token, or rotate the current one if you need fresh code.
6. Copy the snippet or download it as a file.

Example embed snippet

Your actual code will be generated for you. A typical direct-routing install looks like this:

<script
  src="https://widget.requestquote.online/v1.js"
  data-mode="direct"
  data-company-name="Your Business"
  data-widget-token-id="YOUR_WIDGET_TOKEN_ID"
  data-widget-token-secret="YOUR_WIDGET_TOKEN_SECRET"
  data-quote-api-base="https://YOUR_QUOTE_API_BASE"
  data-color="#0f766e"
  data-position="bottom-right"
  async
></script>

What each part does

• data-mode="direct" keeps the request on your business path instead of the marketplace path.
• data-company-name controls the visible label customers see in the widget.
• data-widget-token-id identifies the token created for your company.
• data-widget-token-secret signs the request so the backend can trust the widget submission.
• data-quote-api-base points the widget at the correct backend.
• data-color and data-position let you match the install to your website.

Where to paste it

In most websites, you should paste the script before the closing </body> tag. If you use a CMS such as WordPress, Shopify, Webflow, or a page builder, add it to the custom code area for the pages where you want the widget to appear.

Good first locations are:

• Your contact page
• Your main request-a-quote page
• Your homepage if most visitors start there

Security checklist

• Do not publish the widget secret in screenshots, public documentation, or code samples.
• Rotate the token after handing the website to an agency or contractor if you are unsure who retained access.
• Revoke the active token immediately if you want to disable an install.
• Only owners can issue or rotate widget credentials in the dashboard flow.

How to test the install

1. Publish the updated page.
2. Open it in a private browser window.
3. Launch the widget and submit a realistic request.
4. Confirm the lead appears in your request workflow.
5. Rotate the token and repeat the test if you want to verify credential refresh.

When to use marketplace mode instead

Use direct mode for your own website. Marketplace mode is the better fit for public or shared funnels where the request should go to matching providers instead of one named business. If you run a trade association page, a community referral site, or a Quixo-owned campaign page, marketplace mode can still make sense. For a provider's own site, direct mode is the intended default.