# Widget URL parameters

Add these to the widget's address to prefill the address, open on one trade, and carry ad tracking into the lead. They work on the homeowner link and on the iframe's src.

Source: https://measuredbid.com/docs/url-parameters

## Parameters

| Parameter | Example | What it does |
| --- | --- | --- |
| `address` | `?address=412 Sample Ridge Ct, Roseville, CA` | Fills in the address box. The homeowner still picks and confirms the house. Up to 200 characters. |
| `service` | `?service=gutters` | Opens the widget on one trade. Ignored if the widget doesn't offer that trade. Values: `gutters`, `painting`, `siding`, `roofing`, `lighting`, `holiday`, `washing`. |
| `utm_source`, `utm_medium`, `utm_campaign`, `utm_term`, `utm_content` | `?utm_source=facebook&utm_campaign=spring` | Saved with the lead under `utm`. Up to 300 characters each. |
| `gclid`, `gbraid`, `wbraid`, `fbclid`, `msclkid` | `?gclid=abc123` | Ad click IDs, saved with the lead under `utm`. |
| `ref` | Set by the embed code | The page the widget was on, saved as `utm.referrer`. Without it, the browser's referrer is used. |

URL-encode values, as browsers do for links. Unknown parameters are ignored. Colors, questions and prices come from the widget's settings, not the URL.

## Ad tracking

The embed code copies these parameters from your page's address into the widget, so an ad that lands on your quote page is credited to the lead with no extra work. With a plain link, add them to the link yourself:

Link with tracking:

```text
https://measuredbid.com/quote/your-widget-id?service=gutters&utm_source=facebook&utm_medium=paid&utm_campaign=spring
```

## WordPress shortcode options

| Option | Default | What it does |
| --- | --- | --- |
| `brand` | The widget ID saved in Settings, Measured Bid | Which widget to show: `[instant_quote brand="your-widget-id"]`. |
| `service` | None | Opens on one trade, like the `service` parameter. |
| `title` | `Instant price` | The iframe's title, which screen readers announce. |
| `min_height` | `640` | Height in pixels while it loads. At least 320. |