[{"data":1,"prerenderedAt":707},["ShallowReactive",2],{"navigation":3,"\u002Fdocs\u002Fgetting-started\u002Fform-builders":61,"\u002Fdocs\u002Fgetting-started\u002Fform-builders-surround":702},[4,27,41],{"title":5,"path":6,"stem":7,"children":8,"icon":26},"Getting Started","\u002Fdocs\u002Fgetting-started","1.docs\u002F1.getting-started\u002F1.index",[9,10,14,18,22],{"title":5,"path":6,"stem":7},{"title":11,"path":12,"stem":13},"Installation","\u002Fdocs\u002Fgetting-started\u002Finstallation","1.docs\u002F1.getting-started\u002F2.installation",{"title":15,"path":16,"stem":17},"Settings","\u002Fdocs\u002Fgetting-started\u002Fsettings","1.docs\u002F1.getting-started\u002F3.settings",{"title":19,"path":20,"stem":21},"Showing the Result in Your Emails","\u002Fdocs\u002Fgetting-started\u002Fform-builders","1.docs\u002F1.getting-started\u002F4.form-builders",{"title":23,"path":24,"stem":25},"Data Sources","\u002Fdocs\u002Fgetting-started\u002Fdata-sources","1.docs\u002F1.getting-started\u002F5.data-sources","i-lucide-rocket",{"title":28,"path":29,"stem":30,"children":31,"icon":40},"WordPress Plugin","\u002Fdocs\u002Fwordpress-plugin","1.docs\u002F2.wordpress-plugin\u002F1.index",[32,33,36],{"title":28,"path":29,"stem":30},{"title":11,"path":34,"stem":35},"\u002Fdocs\u002Fwordpress-plugin\u002Finstallation","1.docs\u002F2.wordpress-plugin\u002F2.installation",{"title":37,"path":38,"stem":39},"Configuration","\u002Fdocs\u002Fwordpress-plugin\u002Fconfiguration","1.docs\u002F2.wordpress-plugin\u002F3.configuration","i-lucide-puzzle",{"title":42,"path":43,"stem":44,"children":45,"icon":60},"Developer API","\u002Fdocs\u002Fdeveloper-api","1.docs\u002F3.developer-api\u002F1.index",[46,48,52,56],{"title":47,"path":43,"stem":44},"Developer Guide",{"title":49,"path":50,"stem":51},"Authentication","\u002Fdocs\u002Fdeveloper-api\u002Fauthentication","1.docs\u002F3.developer-api\u002F2.authentication",{"title":53,"path":54,"stem":55},"API Reference","\u002Fdocs\u002Fdeveloper-api\u002Fapi-reference","1.docs\u002F3.developer-api\u002F3.api-reference",{"title":57,"path":58,"stem":59},"Code Examples","\u002Fdocs\u002Fdeveloper-api\u002Fexamples","1.docs\u002F3.developer-api\u002F4.examples","i-lucide-code-2",{"id":62,"title":19,"body":63,"description":694,"extension":695,"head":696,"meta":697,"navigation":698,"ogImage":696,"path":20,"robots":696,"schemaOrg":696,"seo":699,"sitemap":700,"stem":21,"__hash__":701},"docs\u002F1.docs\u002F1.getting-started\u002F4.form-builders.md",{"type":64,"value":65,"toc":681},"minimark",[66,70,74,79,82,93,105,109,125,128,211,214,218,221,267,274,277,280,286,293,299,302,338,341,365,369,403,407,410,489,493,507,570,574,581,585,592,677],[67,68,19],"h1",{"id":69},"showing-the-result-in-your-emails",[71,72,73],"p",{},"There are three ways to get \"in \u002F outside your service area\" into the enquiry emails you receive. Most people don't need to do anything.",[75,76,78],"h2",{"id":77},"_1-automatically-in-the-message-every-website-builder","1. Automatically, in the message (every website builder)",[71,80,81],{},"When a visitor sends your form, Service Area WIZARD adds a line to the end of the form's message box:",[83,84,90],"pre",{"className":85,"code":87,"language":88,"meta":89},[86],"language-text","I need a leaky tap fixed.\n\n— Service area check: SE28 8NZ is outside the service area (23.4 km away)\n","text","",[91,92,87],"code",{"__ignoreMap":89},[71,94,95,96,100,101,104],{},"Your form emails the message as normal, so the line shows up in your enquiry email on WordPress, Wix, Squarespace, Webflow, Shopify and plain HTML forms, with no setup. You can turn this off per site on the ",[97,98,99],"strong",{},"Sites"," page (",[97,102,103],{},"Add the result to the enquiry message",").",[75,106,108],{"id":107},"_2-wordpress-plugin-contact-form-7-wpforms-gravity-forms-elementor","2. WordPress plugin (Contact Form 7, WPForms, Gravity Forms, Elementor)",[71,110,111,112,116,117,120,121,124],{},"If you use the ",[113,114,115],"a",{"href":29},"WordPress plugin",", it checks the postcode on your server when the form is submitted and adds the result to ",[97,118,119],{},"every email the form sends",": your notification and the auto-reply to the customer. No hidden fields needed. It's on by default under ",[97,122,123],{},"Settings → Service Area WIZARD → Form emails",".",[71,126,127],{},"To put the result somewhere specific in an email template instead, untick that setting and use these tags:",[129,130,131,150],"table",{},[132,133,134],"thead",{},[135,136,137,141,144,147],"tr",{},[138,139,140],"th",{},"Form plugin",[138,142,143],{},"Full sentence",[138,145,146],{},"Status",[138,148,149],{},"Distance (km)",[151,152,153,174,194],"tbody",{},[135,154,155,159,164,169],{},[156,157,158],"td",{},"Contact Form 7",[156,160,161],{},[91,162,163],{},"[_saw_result]",[156,165,166],{},[91,167,168],{},"[_saw_status]",[156,170,171],{},[91,172,173],{},"[_saw_distance]",[135,175,176,179,184,189],{},[156,177,178],{},"WPForms",[156,180,181],{},[91,182,183],{},"{saw_result}",[156,185,186],{},[91,187,188],{},"{saw_status}",[156,190,191],{},[91,192,193],{},"{saw_distance}",[135,195,196,199,203,207],{},[156,197,198],{},"Gravity Forms",[156,200,201],{},[91,202,183],{},[156,204,205],{},[91,206,188],{},[156,208,209],{},[91,210,193],{},[71,212,213],{},"Elementor forms don't support custom tags, so the result is always added to the end of the email.",[75,215,217],{"id":216},"_3-hidden-fields-advanced","3. Hidden fields (advanced)",[71,219,220],{},"If you'd rather have the result as separate fields, for example to filter enquiries in a CRM, Service Area WIZARD also fills in two values on your form:",[129,222,223,233],{},[132,224,225],{},[135,226,227,230],{},[138,228,229],{},"Field",[138,231,232],{},"Example value",[151,234,235,255],{},[135,236,237,242],{},[156,238,239],{},[91,240,241],{},"service_area_status",[156,243,244,247,248,251,252],{},[91,245,246],{},"In service area",", ",[91,249,250],{},"Outside service area"," or ",[91,253,254],{},"Unknown",[135,256,257,262],{},[156,258,259],{},[91,260,261],{},"service_area_distance_km",[156,263,264],{},[91,265,266],{},"12.4",[71,268,269,270,273],{},"Most form builders only keep fields they know about, so add two ",[97,271,272],{},"hidden fields"," to your form. Here's how for the most popular ones.",[75,275,158],{"id":276},"contact-form-7",[71,278,279],{},"Add these to your form template:",[83,281,284],{"className":282,"code":283,"language":88,"meta":89},[86],"[hidden service_area_status]\n[hidden service_area_distance_km]\n",[91,285,283],{"__ignoreMap":89},[71,287,288,289,292],{},"Then add them to the ",[97,290,291],{},"Mail"," tab:",[83,294,297],{"className":295,"code":296,"language":88,"meta":89},[86],"Service area: [service_area_status]\nDistance: [service_area_distance_km] km\n",[91,298,296],{"__ignoreMap":89},[75,300,178],{"id":301},"wpforms",[303,304,305,313,332],"ol",{},[306,307,308,309,312],"li",{},"Add two ",[97,310,311],{},"Hidden Field"," fields to your form.",[306,314,315,316,319,320,323,324,327,328,331],{},"For each one, open ",[97,317,318],{},"Advanced"," and set ",[97,321,322],{},"CSS Classes"," to ",[91,325,326],{},"saw-status"," and ",[91,329,330],{},"saw-distance"," respectively.",[306,333,334,335,124],{},"Add them to your notification email using ",[97,336,337],{},"Show Smart Tags",[75,339,198],{"id":340},"gravity-forms",[303,342,343,348,358],{},[306,344,308,345,312],{},[97,346,347],{},"Hidden",[306,349,350,351,323,354,327,356,331],{},"In each field's settings, set ",[97,352,353],{},"Custom CSS Class",[91,355,326],{},[91,357,330],{},[306,359,360,361,364],{},"They're included in ",[91,362,363],{},"{all_fields}",", or insert them into your notification with the merge tag picker.",[75,366,368],{"id":367},"elementor-forms","Elementor forms",[303,370,371,376,389],{},[306,372,373,374,124],{},"Add two fields of type ",[97,375,347],{},[306,377,378,379,381,382,323,385,327,387,124],{},"Open ",[97,380,318],{}," and set the ",[97,383,384],{},"ID",[91,386,241],{},[91,388,261],{},[306,390,391,392,395,396,399,400,124],{},"Use the shortcodes shown under each field (e.g. ",[91,393,394],{},"[field id=\"service_area_status\"]",") in your ",[97,397,398],{},"Email"," message, or leave the message as ",[91,401,402],{},"[all-fields]",[75,404,406],{"id":405},"html-forms","HTML forms",[71,408,409],{},"Nothing to do. If your form posts normally, the two fields are added automatically. To control where they go, add them yourself:",[83,411,415],{"className":412,"code":413,"language":414,"meta":89,"style":89},"language-html shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","\u003Cinput type=\"hidden\" name=\"service_area_status\">\n\u003Cinput type=\"hidden\" name=\"service_area_distance_km\">\n","html",[91,416,417,460],{"__ignoreMap":89},[418,419,422,426,430,434,437,440,444,446,449,451,453,455,457],"span",{"class":420,"line":421},"line",1,[418,423,425],{"class":424},"sMK4o","\u003C",[418,427,429],{"class":428},"swJcz","input",[418,431,433],{"class":432},"spNyl"," type",[418,435,436],{"class":424},"=",[418,438,439],{"class":424},"\"",[418,441,443],{"class":442},"sfazB","hidden",[418,445,439],{"class":424},[418,447,448],{"class":432}," name",[418,450,436],{"class":424},[418,452,439],{"class":424},[418,454,241],{"class":442},[418,456,439],{"class":424},[418,458,459],{"class":424},">\n",[418,461,463,465,467,469,471,473,475,477,479,481,483,485,487],{"class":420,"line":462},2,[418,464,425],{"class":424},[418,466,429],{"class":428},[418,468,433],{"class":432},[418,470,436],{"class":424},[418,472,439],{"class":424},[418,474,443],{"class":442},[418,476,439],{"class":424},[418,478,448],{"class":432},[418,480,436],{"class":424},[418,482,439],{"class":424},[418,484,261],{"class":442},[418,486,439],{"class":424},[418,488,459],{"class":424},[75,490,492],{"id":491},"shopify","Shopify",[71,494,495,496,251,499,502,503,506],{},"Edit your theme's contact form (usually ",[91,497,498],{},"sections\u002Fcontact-form.liquid",[91,500,501],{},"main-contact-form.liquid",") and add these inside the ",[91,504,505],{},"{% form 'contact' %}"," block:",[83,508,510],{"className":412,"code":509,"language":414,"meta":89,"style":89},"\u003Cinput type=\"hidden\" name=\"contact[service_area_status]\">\n\u003Cinput type=\"hidden\" name=\"contact[service_area_distance_km]\">\n",[91,511,512,541],{"__ignoreMap":89},[418,513,514,516,518,520,522,524,526,528,530,532,534,537,539],{"class":420,"line":421},[418,515,425],{"class":424},[418,517,429],{"class":428},[418,519,433],{"class":432},[418,521,436],{"class":424},[418,523,439],{"class":424},[418,525,443],{"class":442},[418,527,439],{"class":424},[418,529,448],{"class":432},[418,531,436],{"class":424},[418,533,439],{"class":424},[418,535,536],{"class":442},"contact[service_area_status]",[418,538,439],{"class":424},[418,540,459],{"class":424},[418,542,543,545,547,549,551,553,555,557,559,561,563,566,568],{"class":420,"line":462},[418,544,425],{"class":424},[418,546,429],{"class":428},[418,548,433],{"class":432},[418,550,436],{"class":424},[418,552,439],{"class":424},[418,554,443],{"class":442},[418,556,439],{"class":424},[418,558,448],{"class":432},[418,560,436],{"class":424},[418,562,439],{"class":424},[418,564,565],{"class":442},"contact[service_area_distance_km]",[418,567,439],{"class":424},[418,569,459],{"class":424},[75,571,573],{"id":572},"webflow-squarespace-and-wix","Webflow, Squarespace and Wix",[71,575,576,577,580],{},"These builders don't support custom hidden fields in their built-in forms. Use option 1 above (the result in the message), which works on all of them. You can also see every check, with the distance, on your dashboard's ",[97,578,579],{},"Overview"," page.",[75,582,584],{"id":583},"for-developers","For developers",[71,586,587,588,591],{},"When a check completes, a ",[91,589,590],{},"serviceareawizard:result"," event bubbles up from the postcode field:",[83,593,597],{"className":594,"code":595,"language":596,"meta":89,"style":89},"language-js shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","document.addEventListener('serviceareawizard:result', (event) => {\n  \u002F\u002F event.detail: { status: 'in_area' | 'out_of_area' | 'not_found', distance_km, postcode }\n  console.log(event.detail)\n})\n","js",[91,598,599,640,646,669],{"__ignoreMap":89},[418,600,601,605,607,611,614,617,619,621,624,627,631,634,637],{"class":420,"line":421},[418,602,604],{"class":603},"sTEyZ","document",[418,606,124],{"class":424},[418,608,610],{"class":609},"s2Zo4","addEventListener",[418,612,613],{"class":603},"(",[418,615,616],{"class":424},"'",[418,618,590],{"class":442},[418,620,616],{"class":424},[418,622,623],{"class":424},",",[418,625,626],{"class":424}," (",[418,628,630],{"class":629},"sHdIc","event",[418,632,633],{"class":424},")",[418,635,636],{"class":432}," =>",[418,638,639],{"class":424}," {\n",[418,641,642],{"class":420,"line":462},[418,643,645],{"class":644},"sHwdD","  \u002F\u002F event.detail: { status: 'in_area' | 'out_of_area' | 'not_found', distance_km, postcode }\n",[418,647,649,652,654,657,659,661,663,666],{"class":420,"line":648},3,[418,650,651],{"class":603},"  console",[418,653,124],{"class":424},[418,655,656],{"class":609},"log",[418,658,613],{"class":428},[418,660,630],{"class":603},[418,662,124],{"class":424},[418,664,665],{"class":603},"detail",[418,667,668],{"class":428},")\n",[418,670,672,675],{"class":420,"line":671},4,[418,673,674],{"class":424},"}",[418,676,668],{"class":603},[678,679,680],"style",{},"html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sHdIc, html code.shiki .sHdIc{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#EEFFFF;--shiki-default-font-style:italic;--shiki-dark:#BABED8;--shiki-dark-font-style:italic}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}",{"title":89,"searchDepth":462,"depth":462,"links":682},[683,684,685,686,687,688,689,690,691,692,693],{"id":77,"depth":462,"text":78},{"id":107,"depth":462,"text":108},{"id":216,"depth":462,"text":217},{"id":276,"depth":462,"text":158},{"id":301,"depth":462,"text":178},{"id":340,"depth":462,"text":198},{"id":367,"depth":462,"text":368},{"id":405,"depth":462,"text":406},{"id":491,"depth":462,"text":492},{"id":572,"depth":462,"text":573},{"id":583,"depth":462,"text":584},"How the service area result reaches your enquiry emails, automatically in the message, through the WordPress plugin, or with hidden fields.","md",null,{},true,{"title":19,"description":694},{"loc":20},"wQIMa0TwWYFMd6c7m4dOQuxnToXsr7ZZyJDaDn_A4m8",[703,705],{"title":15,"path":16,"stem":17,"description":704},"Choose what happens to out-of-area enquiries, customise messages, and point Service Area WIZARD at the right form field.",{"title":23,"path":24,"stem":25,"description":706},"The postcode, zip code and boundary data Service Area WIZARD uses, and the licences it's used under.",1794036043061]