Description
PuzzleListing connects WordPress to the Uberall platform, the leading location data management and listings sync service. Whether you manage a single location or hundreds of franchise branches, PuzzleListing keeps your business data consistent everywhere it matters.
What it does
- Locations sync – Pull all your Uberall locations into WordPress automatically via scheduled background sync or on-demand manual sync.
- NAP consistency – Name, address, and phone data stay aligned across every directory Uberall feeds, including Google Business Profile, Facebook, Apple Maps, Bing, Yelp, and 100+ more.
- Photo import – Exterior photos from Uberall are downloaded and stored in your WordPress media library.
- Static map generation – Optionally attach a Google Maps Static API image to each location post.
- Multi-location ready – Built for franchises, retail chains, restaurant groups, and any business with multiple branches.
Why use it?
Inconsistent listing data is one of the biggest local SEO problems. If your address, phone number, or opening hours differ between Google, Facebook, and your website, search engines lose trust – and customers get frustrated. PuzzleListing makes your WordPress site the reliable source of truth, always in sync with your Uberall location manager dashboard.
Works with
Uberall Location Manager · Uberall GEO Studio
External services
This plugin communicates with the following third-party services:
Uberall API
Connects to the Uberall REST API to sync business and location data.
- What is sent: Your Uberall API key (as a request header) and pagination parameters. No visitor data is transmitted.
- When: During scheduled background syncs and manual syncs triggered from the settings page.
- Endpoints used:
https://uberall.com/api/businesseshttps://uberall.com/api/locations
- Terms of service: https://uberall.com/en-us/na-terms
- Privacy policy: https://uberall.com/en-us/privacy-notice
Uberall media storage (Amazon S3)
Location photos are downloaded from Uberall-managed S3 storage and imported into the WordPress media library.
- What is sent: No data is sent; the plugin performs a one-way download of image files.
- When: During enrichment phase of a sync, when exterior photos are attached in Uberall.
- Storage domain:
https://s3.eu-central-1.amazonaws.com/uberall-userpics-prod/ - Terms of service: https://uberall.com/en-us/na-terms
- Privacy policy: https://uberall.com/en-us/privacy-notice
Google Maps Static API
Optionally downloads a static map image for each location.
- What is sent: Latitude, longitude, and your Google Maps API key.
- When: Once per location during enrichment, only if a Google Maps API key is configured and no map image exists yet.
- Endpoint used:
https://maps.googleapis.com/maps/api/staticmap - Terms of service: https://cloud.google.com/maps-platform/terms
- Privacy policy: https://policies.google.com/privacy
Blocks
This plugin provides 1 block.
- GEO Locations Shows your locations as list or grid
Installation
- Upload the plugin folder to
/wp-content/plugins/. - Activate the plugin through the Plugins menu in WordPress.
- Go to Settings > PuzzleListing – Multi-Location Manager.
- Enter your Uberall API key and save.
- Run your first sync via the Sync now button or wait for the next scheduled run.
FAQ
-
Does this plugin work with Uberall GEO Studio?
-
Yes. PuzzleListing uses the standard Uberall REST API, which is the same data layer that powers Uberall GEO Studio. Any location data you manage in GEO Studio will be reflected in WordPress after a sync.
-
What is Uberall and what is a location manager?
-
Uberall is a location marketing platform that lets businesses manage their presence across hundreds of online directories from a single dashboard – a so-called “location manager” or “listings manager”. PuzzleListing brings that data into WordPress.
-
Can I use this with multiple business locations or a franchise?
-
Yes. The plugin syncs all locations returned by the Uberall API for your account, making it well-suited for franchise networks, multi-branch retailers, and restaurant chains.
-
Does this plugin help with local SEO and citations?
-
Indirectly, yes. By keeping your location data in sync with Uberall – which distributes to Google Business Profile, Facebook, Apple Maps, Bing, and dozens of other directories – you maintain consistent NAP (name, address, phone) data, which is a foundational local SEO ranking factor.
-
Which directories does Uberall sync with?
-
Uberall distributes to 100+ directories including Google Business Profile, Facebook, Apple Maps, Bing Places, Yelp, Foursquare, TripAdvisor, and many country-specific portals. The full list depends on your Uberall subscription.
-
How often does the sync run?
-
By default the plugin runs a scheduled background sync. You can also trigger an instant sync manually from the settings page.
-
Is personal visitor data sent to Uberall?
-
No. Only your Uberall API key and pagination parameters are transmitted. No visitor or customer data from your WordPress site is shared.
-
What is the difference between this plugin and managing locations directly in Uberall?
-
Uberall’s own dashboard is where you edit location data. PuzzleListing reads that data and makes it available inside WordPress – useful when your site displays a store locator, location pages, or structured data powered by WordPress content.
-
Does the plugin require WooCommerce?
-
No. PuzzleListing is independent of WooCommerce and any e-commerce plugin.
-
What happens if the Uberall API is unreachable?
-
The sync will fail gracefully and log an error. No existing WordPress data will be overwritten. The next scheduled sync will retry automatically.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Puzzlelisting – Multi-Location Manager” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Puzzlelisting – Multi-Location Manager” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.