Getting started with Locations

Getting started with Locations

Estimated 7 minute read

Updated Jun 25, 2026, 12:00 AM EST

Table of contents

Why use Locations
Before you begin
Create a location manually
Use an AI assistant
View your location data
Delete a location
Best practices
Outcome
Additional resources

Learn how to add and manage physical locations in Klaviyo so you can identify nearby audiences and target your local campaigns. Once you add a location, you can create proximity-based segments, assign a profile property, and view campaign performance and segment growth from a single location detail page. You can also start a campaign from there, with Composer pre-filling a prompt from your location's details.

Locations is not retail-only. Distributor, Gym, Hotel, Restaurant, Retail store, and Spa are built in, and you can create your own type. Locations and Live Events are both part of Location Hub, and each has its own place under Audience in the left navigation.

Owner, Admin, and Manager have write access.
Campaign coordinator, content manager, and social media manager have read-only access.

Why use Locations

Most brands managing physical locations keep that information outside Klaviyo, in spreadsheets, shared docs, and browser tabs. When it comes time to send, you end up rebuilding the same context by hand: looking up the right ZIP code, finding the segment you made last quarter, copying the address and hours into the email.

Locations gives that information a home in Klaviyo. Each location is a record you create once and reference everywhere, so your segments, campaigns, and profile data all point at the same source.

Before you begin

Decide how you want to add your locations. Klaviyo offers 4 methods:

Sync Shopify pulls locations from your connected Shopify integration. Requires Shopify Markets sync enabled in your Klaviyo integration settings.
Upload a CSV file adds many locations at once.
Use an AI assistant lets ChatGPT, Claude, or another AI assistant add locations for you.
Enter manually adds locations one at a time.

Locations works by connecting 3 things: the location itself, the segments that define its audience, and the profile property that tags those profiles. Adding the address and other details gives you a place to keep that information. Linking segments and adding the profile property is what lets you send to a local audience, track how that audience grows, and reference the location's details in your campaigns.

Create a location manually

Navigate to Audience > Locations.
Click Create a location.
Select Enter manually, then click Next.
Complete the setup steps: details, segments, and profile property.

Add location details

Required fields

Store name, a descriptive name such as Downtown Boston
Type: Distributor, Gym, Hotel, Restaurant, Retail store, or Spa. If none apply, create your own. Type is used to filter your locations list
Street Address, City, State, and Postal code

Optional fields

Description, such as hours or what the location offers
Country, Apartment or suite, Phone number, Website URL, Location email, Manager's name, Manager's email address

Your location's details are passed to Composer when you promote a location, so filling in the optional fields makes that handoff more useful.

Create or link proximity-based segments

Segments define the audience Klaviyo uses when you launch campaigns for this location. Without a linked segment, a location has no active audience and its reporting stays empty.

Link segments you already have, or create a new one in the flow. When you create a segment here, Klaviyo pre-fills a template using the details you entered:

Distance from location, how close a profile must be to join the segment. The default is 30 miles
Marketing channels, which channels a profile must be subscribed to, from email, text message, mobile push, and WhatsApp

Adjust the radius, change the channels, or add conditions the same way you would in the segment builder.

Limits and rules

You can link up to 20 segments per location
A segment can be linked to only 1 location at a time
You can add, link, or unlink segments later in Settings > Segments

Segments already linked to another location are flagged with a warning icon. If you select one, Klaviyo tells you it will be unlinked from its current location and linked to this one. Segment growth is measured from when the segment was created, not when it was linked, so linking an existing segment brings its full history with it.

Profile counts take a few minutes to populate after a new segment is created. While that is happening, the Segments tab shows a Segment data is syncing banner and the metrics read zero. The numbers fill in once syncing finishes.

Add a profile property

The profile property tags profiles in your linked segments with the location they are near. It is what lets you reference location data dynamically in campaigns and flows, and segment on the location a profile is near.

Klaviyo sets this up for you. The property name defaults to store_region, which you can change on this step the first time you set it up. Whatever name you choose applies to every location in your account. The value is the location name, so a location named Austin produces store_region: Austin.

Profiles are tagged automatically through segment membership. Anyone in a linked segment receives the property, and anyone who joins the segment later receives it then.

You can edit both the name and the value in Settings > Profile property. Changing the property name updates it for every location in your account. Changing the value updates only this location. Because the name is shared, renaming it from any one location changes it everywhere, so if you already reference the property in templates, segments, or flows, check those before you rename it.

A profile's store_region value is set when it enters a linked segment and does not change afterward. Relinking the segment to another location, deleting the location, or unlinking the segment all leave the existing value in place. Only profiles entering a segment for the first time receive the current location's value. A segment that has moved between locations can therefore hold a mix of values.

Changing a location's address does not update the proximity segments already linked to it. To target the new address, edit the segment definition.

Use an AI assistant

Connect Klaviyo to ChatGPT, Claude, or another AI assistant and ask it to add your locations. You only need to connect once.

Navigate to Audience > Locations, click Create a location, then select Use an AI assistant and click Next.
In your AI assistant, open its settings for connectors or MCP servers and add a custom connector.
Name it Klaviyo and paste the MCP server URL shown on this screen.
Click Connect next to the connector, then allow access to this Klaviyo account.
Back in Klaviyo, select I've connected my AI assistant, then click Done.

After you click Done, Klaviyo returns you to your locations list, or to the Locations start page if you do not have any locations yet.

Unlike the other methods, your assistant does not create a proximity segment unless you ask for one. Say so in your prompt, or you will end up with a location that has no audience and no reporting. The profile property is handled for you either way.

Example prompts

For one location:

Add a location to Klaviyo: Downtown Boston, retail store, 125 Summer St, Boston, MA 02111. Create a linked proximity segment for profiles within 30 miles who can receive email or text message.

For several locations at once:

Add these locations to Klaviyo. For each one, use: name, type, street address, city, state, postal code. Optional: description, phone number, website URL, location email, manager name, manager email. [paste your locations] For each location, also create a linked proximity segment for profiles within 30 miles who can receive email or text message. When you're done, list each location you created and confirm its segment is linked.

Asking for the confirmation at the end gives you something to check against, which matters when you are adding many locations at once.

Developers can also call these endpoints directly. See Getting started with Klaviyo APIs and the Location Hub API overview in the developer docs. The endpoints are in beta, which means you should not build an application on them since they may change. One-off setup through an AI assistant is what they are intended for.

View your location data

Each location has its own detail page with 4 tabs: Campaigns, Segments, Live Events, and Performance.

Campaigns, campaigns sent to this location's linked segments, plus a Notify segments action that opens Composer with a prompt built from this location's details
Segments, profile counts and growth across all linked segments
Live Events, events at this location, in list or calendar view
Performance, in-store purchase and revenue data. Fills in once you link a Shopify location

Select the Dashboard tab to compare audience growth across all your locations. For what each metric measures and how it is calculated, see Understanding location reporting.

If your account is out of Composer credits, the Notify segments prompt still opens but cannot be sent.

Delete a location

Deleting a location does not delete anything else. Your segments, profiles, and in-store order history stay as they are. Segments linked to the location are not deleted either, so they stay in your account and can be linked to another location.

Profiles also keep the store_region value they were given, so profiles tagged store_region: Austin keep that value after the Austin location is deleted. To clear or change it, update those profiles directly.

Best practices

Complete the full setup for each location. A location with no linked segment has no audience and no reporting.
Start with a few locations. Add 1 to 3 locations first and confirm the segments and profile property look right before adding the rest.
Keep the description current. Composer uses it, along with the address and hours, when you promote a location.
Review what Klaviyo set up for you. Segments and the profile property are a starting point, and everything stays editable in settings.

Outcome

You can now add a location, give it an audience through linked segments, and tag profiles with the location they are near. Your location detail page shows the campaigns you have sent to that audience and how it is growing.