How to Add and Set Up the Address Search & Preview Widget on Your Form

April 17, 2026

Jotform’s Address Search & Preview widget lets users quickly find and verify addresses with real-time autocomplete and an interactive map preview. It minimizes manual entry, improves data accuracy, and streamlines the address collection experience across both desktop and mobile devices.

Once an address is selected, the widget automatically fills in essential details—such as street address, city, state/province, and postal/ZIP code—ensuring your data remains clean, consistent, and ready for use.

Here are a few ways to use it:

  • Collect accurate delivery and shipping addresses
  • Speed up registrations and service requests
  • Reduce manual address entry in your forms
  • Verify customer locations for bookings or on-site services
  • Improve data consistency for CRM and database integrations

Note

You can use OpenStreetMap as the default map provider. However, if you require a more advanced experience, the widget also supports Google Maps, but this requires a Google Maps API Key. To get an API Key, take a look at our guide on How to Get Google Maps API Key for Jotform Mapping Widgets for more details.

Whether you’re building a new form or editing an existing one, you can add and configure the Address Search & Preview widget in just a few steps. Here’s how to set it up:

  1. In Form Builder, click on Add Element on the left side of the page.
Add Element in Jotform Form Builder
  1. Now, in the Form Elements menu, under the Widgets tab, search for Address Search & Preview and click on it. Or, just drag and drop it to where you want it to be on your form.
Address Search & Preview option in the Widgets tab of the Jotform Form Builder
  1. Next, in the Widget Settings menu that opens on the right side of the page, under the General tab, set up these things first:
    • Search Placeholder — Keep the default placeholder text or customize it to guide users on what to enter.
    • Maps Provider — Choose between OpenStreetMap and Google Maps for displaying the map preview.
    • Google Maps API Key — If you select Google Maps as your provider, you’ll need to enter a valid API key, as mentioned above.
Search Placeholder, Maps Provider, and Google Maps API Key in the Address Search & Preview widget settings
  1. Next, scroll down to the bottom and set up these final options:
    • Map Width — Set the width of the map. Select Auto to keep it responsive across all devices, or specify a custom width.
    • Map Height — Set the map’s height. You can also leave this on Auto for a responsive display or define a fixed height.
    • Show Address Fields — Choose Yes to display the address fields, or No to hide them after an address is entered.
    • Show Current Location Icon — Displays a pin on the selected address. Select Yes to show the marker or No to hide it.
  2. Once everything’s set, click on Update.
Map Width, Map Height, Show Address Fields, and Show Current Location Icon in the Address Search & Preview widget settings

That’s it! You’ve now successfully added and set up the Address Search & Preview widget to your form. Curious how it works on a live form? Check out this demo.

Pro Tips

Send Comment:

Jotform Avatar
This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

Podo Comment Be the first to comment.
Still have unanswered questions?

We’re here for you 24/7, anytime you need us day or night. Have a question or need a hand with something? Our team is always ready to help out.