> For the complete documentation index, see [llms.txt](https://docs.woohoo.dance/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.woohoo.dance/ajax-filters/woohoo-map/location-modes.md).

# Location Modes

#### Manual Mode

Add locations directly in the builder:

1. **Content → Locations → Location Source:** Manual
2. Click **Add Location Item**
3. Enter coordinates (Latitude/Longitude) or Address
4. Customize title, subtitle, content, and image per location
5. Set custom markers per location (optional)

**Use case:** Fixed locations like store listings, office addresses

***

#### Dynamic Mode

Pull locations from WordPress posts/CPTs:

1. **Content → Locations → Location Source:** Dynamic
2. Select **Post Type** and **Posts Limit**
3. Configure field mapping:
   * **Latitude Field:** ACF field or post meta name
   * **Longitude Field:** ACF field or post meta name
   * **Address Field:** Address field name (geocoded automatically)
4. Add dynamic elements **directly inside** Woohoo Google Map element

**Use case:** Location-based posts, real estate listings, events

***

#### Dynamic-Sync Mode

Sync map with Ajax Filter Main Query:

1. **Content → Locations → Location Source:** Dynamic-sync
2. **Query Name:** Match your Ajax Filter query name
3. Add **Woohoo Map Connector** element inside your Ajax Filter card template
4. Configure connector fields (latitude, longitude, marker icons)

**Features:**

* Auto-updates when filters applied
* Bidirectional sync (marker ↔ post card)
* Shows empty state when no results

**Use case:** Filterable location directories, searchable maps