FlowsBook a callSign inCreate free accountSign up
Triggers

Form page

Form page starts the flow when someone fills in a form: a page with the fields you choose, which you share as a link or put on your website. Each answer runs the flow once, with the answers as one item; a city or an address is looked up, so the next blocks can search around it. After sending, the page says thank you, shows the results when the run ends within a minute, or emails them.

In the editor: Starts the flow when someone fills in its form: a page with the fields you choose (text, email, phone, a choice, a city or address, a date...), to share or put on your website. Each answer is one item, with each field under its own name; a city or address is looked up and gives the item its place, so the next blocks can search around it.

Settings

Form title

Text

The title at the top of the page. The flow’s name when empty.

Shown at the top of the form page. The flow’s name when empty.

Intro

Text, several lines

A sentence or two under the title: what people get when they send it.

Fields

A setting

Up to 12 fields. Each has a label, a kind (text, long text, number, email, phone, a choice from your options, a place, a date), a help line and whether it is required. The next blocks read each answer as {{its_label_in_lower_case}}, shown under the field.

Each answer reaches the next blocks as {{your_name}}, {{work_email}}, {{city}}; the first place also gives the item its lat and lng.

Needed before the flow can run.

After sending

Pick one

What the page does once it is sent: a thank-you message; the results on the page (a run longer than a minute is emailed instead); or the results emailed to the address typed in the form’s first Email field.

The page says thank you at once; the flow runs on. A Reply after the form is shown only with Show the results on the page.

  • Show a thank-you message
  • Show the results on the page
  • Email the results

Thank-you message

Text

The words shown when the form is sent.

Form page

Pick one

On gives the form its page. The link is under the flow’s ... menu, Form page link.

Switch it On to get the page’s link. Test runs use example answers.

  • Off
  • On

What comes out

Each item that leaves the block carries these fields, to use in the blocks after it as {{field}}.

Each answer

One item for each form sent.

  • <field key>: Each answer, under its field’s key.
  • lat, lng: The position of the first place answered.
  • <field key>_lat, _lng: The position of each place answered.
  • name: The first name, company or text answer.
  • submitted_at: When it was sent.

How to use it

Retail

Free competitor check

A shop owner types their address and gets the businesses like theirs around them, on the page or by email: a lead for your sales team.

Real estate

Area report on request

Buyers ask for a report on an address and receive it as a PDF.

Franchising

Franchise enquiry check

Every enquiry arrives already scored, with the competitors around the proposed site.

Logistics

Nearest depot

Customers type an address and the page answers with the depot that serves it.

Recruiting

Candidates by city

A hiring manager asks for the market in a city and the recruiter gets the companies hiring for that role.

Events

Venue finder

Organizers describe their event and see five venues that fit.

Good to know

  • The form takes answers only while the flow is live and its Form page is On. Test runs use example answers made from your fields.
  • Each answer runs the flow and costs what a run costs; a visitor can send it at most 20 times a day, and the flow’s monthly credit limit holds.
  • Answers are checked on the server too: a required field left empty, an email or a number that is not one, a choice not offered, or a place that cannot be found is sent back to the person.
  • Put Reply after it to show your own words on the page, for example the nearest branch’s name.
  • Replacing the flow’s webhook address gives the form a new link; the old one stops working.
  • The same fields describe the flow when you offer it as a tool to AI assistants.

Works well with

  • Nearby places: Places around a point from xMap’s own places database (300M+ places, refreshed every month): pick the types of place (more than 5,000, such as Restaurant, Cafe, Pharmacy, Hospital or Gas station, or a whole group of them) and how far to look.
  • Reply: Answers whoever started the flow, on the same channel: the app or system that called its Webhook / API gets the answer back, and a message from Slack, WhatsApp, Telegram, Teams, SMS, Outlook or Discord gets a reply in the same chat, through the account of the block that received it.
  • Email: Sends one email per run with all the items, or one email per item.
  • Make a report: Turns the items that reach it into a clean PDF report with your logo and colour: the summary an xMap LLM block wrote for the whole list, the figures, charts of kinds and cities, a map and the list.
  • Travel area: The area you can reach within a travel time (15 minutes by car) or a distance by road (10 km), on foot, by bike or by car, from each incoming place or from places you pick.

Help articles

Read more

Try it

Build a flow with Form page on the home page, no account needed, or book a call. Try it live