Skip to main content

Location Fields

Physical locations or apps where you sell products, ship orders, and manage inventory

Updated today

Sample Files

  • Locations Sample - Add two sample warehouse and retail store locations with US addresses

General

ID

Description

Example Value

Shopify unique location identifier

1234567890

The unique identifier for the location. When importing, the ID is used to identify the existing location. If not provided, the app will try to identify the location by Name.

Name

Description

Example Value

Location name

Main Warehouse

The name of the location. Used for identification if ID is not present.

Command

Description

Example Value

Action to perform: MERGE, DELETE, REPLACE, NEW

MERGE

  • MERGE: Update existing location or create if not found

  • DELETE: Delete the location (cannot delete the default location or a location with active inventory)

  • NEW: Create a new location (will skip if location already exists)

  • UPDATE: Update existing location (will skip if not found)

  • REPLACE: Delete existing location completely and create new with file data

Active

Description

Example Value

Whether the location is active

TRUE

  • TRUE: Location is active and can be used

  • FALSE: Location is deactivated

Fulfills Online Orders

Description

Example Value

Whether location fulfills online orders

TRUE

Indicates whether this location is used to fulfill online orders. This field is export-only and cannot be imported.

Has Active Inventory

Description

Example Value

Whether location has active inventory

TRUE

  • TRUE: Location has inventory items stocked

  • FALSE: Location has no inventory

This field is export-only and cannot be imported.

Is Default

Description

Example Value

Whether this is the default location

FALSE

Indicates if this is the default location for the shop. This field is export-only and cannot be imported. You must set the default location in your Shopify settings. This field is export-only and cannot be imported.

Is Fulfillment Service

Description

Example Value

Whether location is a legacy fulfillment service

FALSE

Indicates if the location is associated with a legacy fulfillment service.

This field is export-only and cannot be imported.

Created At

Description

Example Value

Date and time when location was created

2023-01-15 14:30:00 -0500

The timestamp when the location was created. This field is export-only.

Updated At

Description

Example Value

Date and time when location was last updated

2024-02-20 09:15:30 -0500

The timestamp when the location was last modified. This field is export-only.

Address

Address 1

Description

Example Value

Street address line 1

123 Main St

The primary street address of the location.

Address 2

Description

Example Value

Street address line 2

Unit 4

The secondary street address of the location (e.g., apartment, suite, unit).

City

Description

Example Value

City name

New York

The city where the location is situated.

Province

Description

Example Value

Province/State name

New York

The name of the province or state.

Province Code

Description

Example Value

Province/State code

NY

The two-letter code for the province or state (e.g., NY, CA).

Country

Description

Example Value

Country name

United States

The name of the country. If no country code is provided, Altera will attempt to convert the country name to a code automatically (e.g., "USA", "U.S.A.", "United States", "UK", "Great Britain" are all recognized). If both country and country code are provided, the country code takes precedence.

Country Code

Description

Example Value

Country code

US

The two-letter ISO 3166-1 alpha-2 country code (e.g., US, CA, GB). This field takes precedence over the country name field. If not provided, Altera will attempt to convert the country name to a code.

Zip

Description

Example Value

Postal/Zip code

10001

The postal or zip code of the location.

Phone

Description

Example Value

Phone number

+12125551234

The phone number associated with the location.

Metafields

Metafields

Description

Example Value

Metafields

namespace.key:value

Metafields associated with the location. Format: namespace.key:value or structured columns.

Export Filters

You can use these filters to limit which locations are exported:

  • name: Filter by location name

  • id: Filter by location ID

  • active: Filter by active status (true or false)

Did this answer your question?