To begin, generate an API token by visiting your Mapbox developer dashboard. Once you have your token, enter it into the mapbox_token field in the plugin settings within Bubble.
Next, add the Autofill element onto your page. It can be made very small (for example, 20×20 pixels) and hidden if needed — it just needs to exist on the page.

Create an Input element where the user will type their address. Link this Input to the Autofill element by setting the Autofill’s Address Input field to your new Input element.

To display suggestions, create a GroupFocus element with the Address input as its reference element. Place a RepeatingGroup inside it and set the RepeatingGroup's data source to either suggestions (for simple text results) or suggestion_objects (for full address objects).

Create a workflow that triggers when a RepeatingGroup cell is clicked. Use this workflow to store the selected item's index into a custom state (for example, selected_address_index), and link this state back to the Autofill element’s Selected Index field.

You can use the plugin’s Exposed States to automatically populate other Input fields on your page. For example, you can set the Initial Content of City, State, and Postcode inputs to pull directly from states like place, region, and postcode once a user selects an address. This makes it easy to build dynamic, user-friendly forms without additional workflows.

Exposed States:

suggestions — List of formatted suggestion labels (text only).

suggestion_objects — List of full address objects, each containing detailed components like street, city, state, and postal code.

selected_address_lat — Latitude of the selected address.

selected_address_lng — Longitude of the selected address.

address_line1 — Primary street address (e.g., "123 Main St").

address_line2 — Secondary address line (e.g., apartment or suite number).

place — City or locality name.

district — District or county name.

district_code — Code representing the district or county.

postcode — Postal code (e.g., "90210").

region — State, province, or regional name.

region_code — Abbreviated region code (e.g., "CA").

country — Full country name.

country_code — ISO country code (e.g., "US").

Visit autofillplugin.com to learn more.