Service Areas

Control which locations your Quote Widget accepts quotes from. This helps you focus on leads within your actual service area.

Service Area Types

Serve All Areas

Accept quote requests from any location. Best for:

• Nationwide service providers
• Businesses with no geographic restrictions
• Testing and initial setup

Specific Zip Codes

Accept quotes only from specified zip codes. Best for:

• Local shops with defined service territory
• Mobile services with specific coverage
• Franchises with territory agreements

Specific States

Accept quotes from entire states. Best for:

• Regional businesses
• Multi-state operations
• State-licensed services

Configuring Service Areas

1. Go to Settings > Quote Widget
2. Find the Service Area section
3. Select your service area type
4. Configure the specific settings

Adding Zip Codes

1. Select Specific Zip Codes
2. Enter a 5-digit zip code
3. Click Add
4. Repeat for all service zip codes

Selecting States

1. Select Specific States
2. Check the boxes for states you service
3. Save your changes

Out of Area Message

When a customer enters a zip code outside your service area, they see a customizable message:

Default message:

Sorry, we do not currently service your area.

Custom message example:

We currently serve the Dallas-Fort Worth metroplex. For service outside this area, please call us at (555) 123-4567.

To customize:

1. Go to Settings > Quote Widget
2. Find Out of Area Message
3. Enter your custom message
4. Save changes

Best Practices

Be Generous with Boundaries

Include neighboring zip codes where you might accept jobs. You can always decline individual quotes, but you can't capture leads you never receive.

Update Regularly

As your business grows, update your service area to match. Review quarterly to ensure accuracy.

Consider Mobile Service

If you offer mobile service, your effective service area may be larger than your shop location suggests.

Test Your Configuration

After setting up, test with zip codes both inside and outside your area to verify the correct behavior.

Zip Code Lookup Tools

Need help identifying zip codes in your area? These resources can help:

• USPS ZIP Code Lookup
• ZIP Code Database
• Google Maps (search for city boundaries)

Handling Edge Cases

Customer in Service Area but Different Zip

If a customer's home zip is outside your area but their work zip is inside, they won't be able to submit. Consider:

• Adding common nearby zip codes
• Using the "Serve All Areas" option and filtering leads manually
• Adding a note in your out-of-area message about calling for special arrangements

Seasonal Service Areas

If your service area changes seasonally:

• Update the zip codes as needed
• Use the out-of-area message to explain timing
• Consider "Serve All Areas" with manual filtering

API Access

For advanced integrations, service area validation is available via API:

POST /api/public/service-area/validate
Content-Type: application/json

{
  "tenantSlug": "your-shop",
  "zipCode": "75001"
}

Response:

{
  "valid": true,
  "message": null
}

Or if outside service area:

{
  "valid": false,
  "message": "Sorry, we do not currently service your area."
}

Next Steps

• Customize widget appearance
• Set up event tracking