Charlie syncs automatically with your Shopify locations. Any location you create in Shopify appears in Charlie.
What Charlie adds to locations
| Feature | Description | Used in |
|---|---|---|
| Types | Classify locations as Warehouse or Store | Constraints, Routing |
| Tags | Add custom tags for flexible grouping | Constraints, Routing |
| Capacity | Set daily order limits per location | Routing, Automations |
| Backlog | Track open fulfillment pipeline and rank by queue depth | Routing |
| Handle | URL-friendly identifier for the location | Storefront, API, theme |
| Sales targets | Per-location sales goals tracked in admin and Shopify POS | POS, reporting |
Shipping configuration (which locations ship, shipping zones, carriers) is managed directly in Shopify Admin → Settings → Shipping and delivery.
Identifying locations
Each location has a few identifiers you can use depending on the context:| Identifier | Where it’s set | Use it for |
|---|---|---|
| Name | Shopify Admin → Locations | The merchant-facing display name |
| ID (GID) | Assigned by Shopify (gid://shopify/Location/...) | API calls, CSV imports, function inputs |
| Handle | Charlie → Location detail page → Handle field | URL-friendly references in your storefront or integrations |
Handle
The handle is a short, URL-friendly identifier you assign per location — for example,paris-warehouse or flagship-store. Handles are useful when you need a stable, human-readable reference that doesn’t change if the location name is edited.
Charlie exposes the handle as a public metafield (charlie_location.handle) so it’s accessible from your storefront, theme, or any app that reads location metafields.
Edit the handle
On the location detail page, find the Handle field and click Edit. Pick a short, URL-friendly identifier (lowercase, hyphens, no spaces).
Markets at a glance
The location detail page shows the Shopify Markets each location serves as chips, so you can see at a glance which markets a location is set up for.- Each chip is a market name from your Shopify Markets configuration
- Click a chip to jump to that market in Shopify Admin → Settings → Markets
Charlie reads markets via the
read_markets access scope. If your install was set up before this scope was granted, you may need to re-authorize the app.Browsing your locations
The location list includes pre-created views to help you find locations quickly:| View | Shows |
|---|---|
| All | Every location |
| Active | Locations currently active in Shopify |
| Inactive | Locations that are inactive |
| Stores | Locations with type set to Store |
| Warehouses | Locations with type set to Warehouse |
Why extend locations?
Target rules precisely
Use types and tags to apply constraints and routing rules to specific locations
Scale without rework
New locations inherit rules automatically based on their type and tags
Control capacity
Limit daily orders per location to match staffing and operational capacity
Stay native
Charlie extends Shopify locations—no duplicate configuration
How it works
Example: Regional routing with location tags
A retailer with 3 warehouses and 20 stores wants to:- Route online orders to warehouses only
- Use stores only for local pickup
- Set warehouse locations to type Warehouse
- Set store locations to type Store
- Create a routing rule: prioritize locations where type = Warehouse
Next steps
Types
Classify locations as Warehouse or Store
Tags
Add custom tags for flexible grouping
Capacity
Set daily order limits per location
Sales targets
Track per-location sales goals from admin and POS