Website Widget for Lead Generation

Overview

The website widget lets you embed a job request form directly on your contractor website. Homeowners can submit requests without leaving your site, and you'll receive notifications just like marketplace job requests. It's a simple way to turn website visitors into customers.

Setting Up Your Widget

Accessing Widget Settings

1. Go to Settings in your contractor dashboard
2. Click the "Website Widget" tab
3. Copy the embed code shown on the page

Customizing Your Widget

Before embedding, customize the appearance:

• Primary Color: Main accent color (buttons, headers)
• Accent Color: Secondary elements
• Preview: See changes in real-time on the right side

Getting the Embed Code

Two options for embedding:

Option 1: Script tag (Recommended)

<script src="https://app.blueclerk.com/api/public/widget/script/[your-id]"></script>

Option 2: Container with script

<div id="blueclerk-widget"></div>
<script src="https://app.blueclerk.com/api/public/widget/script/[your-id]"></script>

Installing on Your Website

WordPress

1. Go to your page editor (Pages or Posts)
2. Add a Custom HTML block
3. Paste the embed code
4. Publish or update the page

Wix

1. Open the page editor
2. Click "+ Add" on the left sidebar
3. Choose "Embed Code" or "HTML iframe"
4. Paste the embed code
5. Adjust size as needed (560px wide recommended)
6. Publish your site

Squarespace

1. Edit the page where you want the widget
2. Click an insert point and select "Code"
3. Paste the embed code
4. Click "Apply"
5. Save and publish

Other Platforms

If your website builder supports custom HTML or iframes, paste the embed code in the HTML editor. The widget is responsive and will adapt to your page width (max 560px).

What Homeowners See

The widget displays a simple 5-field form:

• Name (required)
• Email or Phone (at least one required)
• Address (with Google autocomplete)
• Description (required - what they need done)
• Your company name and logo at the top

How Requests Work

When Someone Submits

1. Request is created in your Job Requests list
2. You receive an email notification
3. Request shows "From Website" badge to distinguish from marketplace requests
4. Homeowner account is auto-created if they're new to BlueClerk
5. Property is added based on the address they entered

Finding Widget Requests

Widget requests appear in your Job Requests list with a blue "Website" badge. You can:

• Accept or decline the request
• Contact the homeowner via email/phone
• Create a ticket and schedule the work

Rate Limiting

To prevent spam, the widget limits submissions to 10 requests per hour per IP address. This protects your inbox while allowing legitimate customers to reach you.

Tips

• Place prominently: Put the widget on your homepage or "Request Service" page
• Clear call-to-action: Add text above the widget explaining what it's for
• Mobile-friendly: The widget works on phones and tablets automatically
• Match your branding: Customize colors to match your website design
• Test it: Submit a test request to make sure notifications work

Questions

Q: Can I embed the widget on multiple pages? A: Yes, use the same embed code on as many pages as you want. Each submission goes to the same place.

Q: Will homeowners need to create an account? A: No. The form creates a homeowner account automatically in the background. They don't need to log in.

Q: Can I customize the form fields? A: Not currently. The widget uses a standard 5-field form optimized for job requests. Custom forms are on the roadmap.

Q: What if I get spam? A: The widget has built-in rate limiting (10 requests/hour per IP). You can also decline spam requests, which doesn't affect your stats.

Q: Does the widget work with my existing BlueClerk account? A: Yes. Widget requests appear alongside marketplace job requests. Everything works the same way.

Q: Can I track which requests came from my website? A: Yes. Widget requests are tagged with "From Website" and include the referring URL so you know where they came from.