Wherewell for Webflow: how it works
Served at https://greatwork.company/apps/wherewell-for-webflow/docs. Support: hello@greatwork.company (a person replies within one business day).
How to add a store locator to a Webflow site
- Install and connect. Install Wherewell from the Webflow Apps marketplace and approve your site. Open the site in the Designer, then open Wherewell from the Apps panel.
- Pick your locations. On the Locations tab, choose the CMS collection that holds your stores, offices or dealers. Wherewell suggests the fields: the name, the address fields in order (street, city, region, postcode, country) and two coordinate fields. If the collection has no coordinate fields yet, click Add Latitude and Longitude fields for me. Pick up to four fields visitors can filter by (Option, Switch or text) and up to six details to show (phone, email, website, text). Save.
- Geocode. Click Find items to geocode. Wherewell lists items that have an address but no coordinates, and items whose address changed since it last geocoded them. Click Geocode: each result shows the matched address, the coordinates and how exact the match is (exact, street, approximate). Nothing is written yet. Untick anything that looks wrong, then click Write to the CMS.
- Add it to a page. On Add to page, choose units, distances, map style, pin colour and whether to show Near me. Select the element the locator should go after and click Add the locator to this page. Then publish.
What visitors get
- A search box for an address or postcode, a distance choice and your filters. Results list nearest first with the distance, your details, a link to the item's page (if you turned that on) and a Directions link.
- Near me uses the visitor's browser location (the browser asks them first).
- A map with pins (clustered when there are many), pop-ups and zoom controls. Scrolling the page doesn't zoom the map by accident (hold Ctrl or Cmd, or use two fingers).
The element on your page
Wherewell inserts a normal Webflow element with a data-ww-locator attribute and five areas inside it, marked
with data-ww-role: search, filters, status, list and map. Move them, restyle them, put the map on
top, add your own classes: Wherewell fills whatever areas it finds. Delete the areas you don't want and
Wherewell builds a default layout instead. The map area needs a height (the default style gives it 420px).
Keeping coordinates in sync
With Geocode new and edited items automatically on, Wherewell geocodes items when they're created or their address changes (Webflow tells Wherewell through webhooks). It never overwrites coordinates you placed yourself: if the coordinates in an item differ from what Wherewell last wrote, the item is left alone from then on.
With Publish items that were already live on, an item that was published is published again after its coordinates are written, but only when it had no other changes waiting to be published, so your drafts never go live by surprise. Otherwise the new pin appears the next time you publish.
The map shows published items only. Changes appear on your live site within about five minutes.
Coverage
Address geocoding covers the United States, Canada and Mexico. For other countries, type the coordinates into the Latitude and Longitude fields (decimal degrees, for example 51.5074 and -0.1278). Everything else, including distance search with typed coordinates and Near me, works everywhere. Visitor address search outside those three countries falls back to matching the names and addresses in your list.
Plans and limits
- Standard: $24 a month or $240 a year per site. Up to 1,000 locations on the map, 2,500 lookups a month.
- Pro: $69 a month or $690 a year per site. Up to 25,000 locations, 25,000 lookups a month.
- Workspace: $199 a month or $1,990 a year for every site in a Webflow workspace, with Standard limits on each site.
- 14-day free trial on each site with 500 lookups, starting the first time you geocode or add a locator. No card needed.
- A lookup is one address turned into coordinates: one CMS item geocoded, or one visitor search that isn't already cached. Lookups reset on the 1st of each month (UTC).
- When the trial ends or a plan lapses, geocoding pauses and the locator on your published site hides its content. Your layout and CMS data stay as they are. Pick a plan on the Plan tab to bring it back.
- Switch between Standard and Pro, change your card, get invoices or cancel in Manage billing.
Removing Wherewell
Settings > Remove Wherewell from this site takes the script off every page it was added to, deletes the webhooks it created, deletes everything Great Work stored for the site, and disconnects it. Publish afterwards. Coordinates written to your CMS stay, since they're your content. Then delete the locator element from the page and uninstall the app.
If the app was uninstalled first: open each page that had a locator, go to Page settings > Custom code, remove WherewellLocator, delete the locator element, and publish. (The script does nothing on its own once the site is disconnected.)
Troubleshooting
- The map is empty on the live site. Publish the site after adding the locator, and check that the items are published and have coordinates. The map data refreshes within five minutes; Add to page > Refresh updates it right away.
- "Not found" for an address. Check the spelling, add the city and postcode fields to the address, or type the coordinates in yourself.
- A Number field isn't offered for coordinates. It's set to whole numbers or doesn't allow negatives. Turn on decimals and negative numbers in the field's settings, or use the plain text fields Wherewell can add.
- This month's lookups are used up. They reset on the 1st; Pro has ten times as many.