Embed Widgets

AllServicePros offers two embed products. They solve different jobs:

| Product | Who can use it | What it does | Where you get the code | |---------|----------------|--------------|------------------------| | Verified rating badge | Verified Pro and Business | Shows your verified-job star rating on your site | Developer → Embeds → Rating Badge | | Lead / quote widget | Business plans | Lets visitors request a quote or message you on your site | Developer → Embeds → Forms & Quotes |

This page focuses on installing the verified rating badge. For the lead / quote widget script, use the Embeds dashboard (it generates the only supported snippet). Same docs hub as API / webhooks / MCP: /developers/docs.

Verified rating badge — 5-minute install

Requirements

  1. A completed business profile on AllServicePros
  2. An active Verified Pro ($99/yr) or Business subscription
  3. Access to edit your website HTML (or a CMS “Custom HTML” / “Embed” block)

Free accounts can collect reviews on AllServicePros, but the badge image will show a neutral AllServicePros mark until you upgrade.

Step 1 — Open the Badge panel

  1. Sign in at allservicepros.net
  2. Go to Dashboard → Developer & Integrations
  3. Open Embeds → Rating Badge
  4. Pick a style: standard (200×80), compact (140×50), or minimal (100×30)
  5. Click Copy Code

The copied HTML is a linked image: visitors who click the badge land on your AllServicePros profile (/biz/{slug} for Business, /pro/{slug} for Verified Pro).

Step 2 — Paste into your website

Paste the snippet where you want the badge to appear (footer, About page, homepage trust strip).

Raw HTML / custom site

<a href="https://allservicepros.net/biz/YOUR-SLUG?utm_source=badge" target="_blank" rel="noopener noreferrer">
  <img
    src="https://allservicepros.net/api/badge/business/YOUR-BUSINESS-ID?style=standard"
    alt="AllServicePros verified rating"
    width="200"
    height="80"
    loading="lazy"
  />
</a>

Replace YOUR-BUSINESS-ID and YOUR-SLUG with the values from your dashboard (Copy Code already fills these in).

CMS-specific tips

WordPress

  1. Edit the page or use Appearance → Widgets / Site Editor
  2. Add a Custom HTML block
  3. Paste the snippet and publish

Wix

  1. Add → Embed Code → Embed a widget
  2. Paste the snippet
  3. Resize the embed box so the badge is fully visible

Squarespace

  1. Add a Code block
  2. Paste the snippet
  3. Save and publish

Webflow

  1. Add an Embed element
  2. Paste the snippet
  3. Publish

Shopify

  1. Online Store → Themes → Edit code, or use a custom Liquid section / app block that accepts HTML
  2. Paste the snippet in the footer or product template
  3. Save

Step 3 — Confirm it works

  1. Open your live page (not only the CMS editor preview)
  2. You should see stars and either X.X (N verified jobs) or New on AllServicePros if you have zero verified jobs yet
  3. Click the badge — it should open your AllServicePros profile

If you only see a plain “AllServicePros / Find verified pros” image, check:

  • Your subscription is Verified or Business (not Free)
  • Your business profile is active
  • If you set a domain allowlist, your live site’s domain is on that list (Integrations → Embeds → domain allowlist, shared with the booking widget)

What the badge shows

The badge uses verified jobs only, not every review on your profile.

A review counts toward the badge when all of the following are true:

  1. The client used a secure review link you (or the system) sent
  2. Payment was proven — either a paid invoice on AllServicePros, or an approved Zelle / Venmo / Cash App / invoice / receipt screenshot
  3. The client uploaded before and after work photos
  4. An AllServicePros moderator approved the review

Public label format: 4.9 (42 verified jobs).

Scores can take up to about an hour to refresh after a new review is approved (CDN cache).

Styles

| Style | Size | Query param | Best for | |-------|------|-------------|----------| | Standard | 200×80 | ?style=standard (default) | Homepages, About pages | | Compact | 140×50 | ?style=compact | Sidebars, mobile footers | | Minimal | 100×30 | ?style=minimal | Dense footers |

Example compact URL:

https://allservicepros.net/api/badge/business/YOUR-BUSINESS-ID?style=compact

Domain allowlist (optional)

If badgeAllowedDomains is empty, the badge can load from any site.

If you add domains (for example mycompany.com), embeds from other hostnames may show the neutral image. Manage the list under Dashboard → Integrations → Embeds. The same list is used by the booking widget.

API (advanced)

GET https://allservicepros.net/api/badge/business/{businessId}?style=standard

Returns image/svg+xml. Always prefer copying the snippet from the dashboard so the profile link and IDs stay correct.

Deprecated: GET /api/badge/{professionalId} — use the business endpoint above.

Operator reference (same product): docs/features/badge-widget.md in the repo.

Lead / quote widget (Business)

The lead / quote embed is a separate product from the rating badge. Do not hand-write that HTML.

Visitors on your site can request a quote or send a message (modes: request, message, or both). Submissions create the same RFQ lifecycle as marketplace leads. On-site calendar booking is not shipped yet — use quote/message modes today.

  1. Upgrade to a Business plan
  2. Open Dashboard → Developer & Integrations → Embeds → Forms & Quotes
  3. Choose theme and mode (request / message / both)
  4. Add your website domain to the allowlist
  5. Copy the generated snippet and paste it into your CMS

See also the Embeds tab in your dashboard for live preview. Pro product guide: Showcase. Operator reference: docs/lead-embed.md in the repo.

Production snippets load the script from https://cdn.allservicepros.net/widget.v1.js when NEXT_PUBLIC_WIDGET_CDN_URL is set (see docs/ops/CLOUDFLARE-WIDGET-CDN.md).