Edit or remove multiple locations in Apple Business
You should keep location information updated often, so customers can see the latest hours of operation, special offers, and more.
For more information about place card information for your locations, see Add a place card header.
Requirements
Any user whose role has permissions to manage locations can edit multiple locations.
You need to have five or more locations to edit them using the edit multiple locations template file.
The maximum number of rows in a single file can’t be more than 10,000 rows.
Get started
Review these steps, then follow the tasks below this list to edit multiple locations.
Step 1: Sign in, select which locations you want to edit or remove, then download the edit multiple locations template
.tsvfile from Apple Business.Step 2: Review the column headers and cell requirements for each location.
Step 3: Step 3: Edit the information for each location you want to change.
Step 4: Save the file, then upload the file to Apple Business. If you have errors, fix them, then upload the file again.
Step 5: Send the file to Apple to review and approve the locations’ updated information.
Step 6: Review and fix any errors that Apple Business reports back to you.
Step 7: If necessary, review each location again and update any attributes that have a warning message.
About the ZIP file
The ZIP file contains one file and one folder:
A tab-delimited value
.tsvtemplate file pre-filled with your brand details.The folder contains the following files:
An example
.tsvfile that shows sample values for how to fill out the template accurately.Reference files for the following:
Valid category values.
Valid “Good to Know” values.
Valid “Service Hours” values.
The meaning of each error code and the suggested corrective action.
Step 1: Select which locations you want to edit or remove and download the edit multiple locations template file
You can edit or remove up to 10,000 locations per file.
In Apple Business, sign in with a user whose role has permissions to manage locations.
To view roles and permissions, see Intro to roles and permissions.
In your browser, choose Brands > Locations.
Use the filter to select the locations you want to edit or remove.
Note: If you don’t apply any filters, the exported file includes all locations in your organization.
Select Manage > Edit Multiple Locations.
Select Download Locations (ZIP) to download a .tsv file containing all the selected locations’ information
Step 2: Review the column headers and cell requirements
Review the edit locations template requirements.
Step 3: Edit the information for each location
Edit any necessary information for each location and add it to the template file.
Important: Make sure to check for any spelling errors in street names, city names, and other location information, which may cause errors (for example, an unapproved location) or customer confusion when finding your location. Review the edit multiple locations template.
Step 4: Save and upload the file
Save the file in one of the following formats.
Comma-separated value (
.csv)Tab-separated value (
.tsv)Microsoft Excel spreadsheet (
.xlsx)
Choose one of the following:
Drag the file to the Upload file area.
Select Upload file, then navigate to the folder containing the file you want to upload.
Important: Don’t leave or refresh the webpage until Apple finishes processing the file.
Do one of the following:
If you do have errors, you need to fix them, then upload the file again. Apple Business can’t process a file with errors.
If you didn’t have any errors in your file, Apple Business checks and verifies it. You’ll then see a summary page that shows the following:
The file name.
The number of locations that will be updated.
A breakdown showing the total number of changes by category. For example, Hours: 22, Categories: 13, About: 26.
When the processing is complete, review the information carefully, then proceed to step 5.
Step 5: Send the file to Apple to review and approve the updated locations’ information
Select Send for Review.
Step 6: Review and fix any errors or warnings
After you successfully submit your locations file, you can review the progress in the Activity section of Apple Business. After its processed by Apple, you can also download a report. Each file you submit shows the following:
Operation Name: This includes your uploaded file name.
Status: Displays either In Progress or Completed.
Dates: Displays either the date created or the date updated.
About the locations report file
The report contains the original information you submitted for the location rows with any potential issues and three columns added at the beginning of the report:
Column title | Values | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Status | Warning: The location created with warnings. Error: The location isn’t created. | ||||||||||
Error | If there are errors, the codes appear for the row separated by a comma. | ||||||||||
Warning | If there are warnings, the codes appear for the row separated by a comma. | ||||||||||
In Apple Business, sign in with a user whose role has permissions to manage locations.
To view roles and permissions, see Intro to roles and permissions.
Search for and select Reviewing new locations from [Name of your file].
Select the activity to view the following:
The current number of locations successfully processed.
The number of any potential issues.
A report.
Select Download Error Report, then save and open the file.
Review and fix any errors shown in the report in your original file.
Optional: Remove the first three columns (Status, Error, and Warning), then save the file.
Select Upload Corrected Report, then choose one of the following:
Drag the file to the Upload file area.
Select Upload file, then navigate to the folder containing the file you want to upload.
Do one of the following:
If you do have errors, you need to fix them, then upload the file again. Apple Business can’t process a file with errors.
If you didn’t have any errors in your file, you’ll see the total number of locations you want to edit. You’ll then see a summary page that shows the following:
The file name.
The number of locations that will be updated.
A breakdown showing the total number of changes by category. For example, Hours: 22, Categories: 13, About: 26.
Select Send for Review to send the file to Apple to review and approve the locations’ information.
Step 7: If necessary, review each location and update any attributes that have a warning message
Scroll through your location list to locate any location with a warning message about incorrect attributes.
Select a location, then edit the attributes with errors.
Save the changes.
Repeat this task until there are no errors in any locations.
Review the edit multiple locations template
You use the edit multiple locations template to edit all your locations information.
To download the template, see Download the edit multiple locations template file.
Overview
There are three main content types:
Required: This content is required for the location.
Optional: This content may be added for the location.
Conditional: This content might be required depending on whether optional content is added.
The following location content can’t be added to the template file:
Organization logo
Cover photo
Showcases
Action links (To update Action links for your locations, see Manage Actions for your showcase.)
Best practices
Follow these best practices when using the edit locations template file:
Use the included reference files to find the correct values for Categories, Service hours and “Good to Know” attributes that best represent your locations.
View the example file to understand the correct formatting for each attribute.
Give your file a unique name that you can recognize and easily identify in the Activity Center.
Don’t delete any columns from the template. Rows may be removed if you don't need to add more locations.
You can delete a value from a cell if you want to remove it from the location, as long as it’s not required. Make sure all values you want to keep appear in your file before you submit it.
If a field has more than a single value (for example. “Good to Know,” Additional Categories), use the pipe “|” as the delimiter to separate multiple values. For example, if there are three “Good to Know” attributes for a location, add them in the file using the following format:
Accepts Cash|Accepts Apple Pay|Takeout
For localized or translated content (for example, Alt Language|Name, Alt Language|About Description), pair each language code with its corresponding text using a semicolon “;” and a pipe “|” to separate multiple language entries. For example:
es-US;Brand Cafetería|es-MX;Brand Cafetería
en-US;Your first stop for morning coffee. Fresh daily pastries and espresso.|es-US;Su primera parada para el café de la mañana. Pasteles frescos diarios y espresso.
Hours can be entered as free text. You don’t need to follow a strict format. See the Edit locations template content list.
If a numeric field starts with a zero (for example, a postal code), start the value with an apostrophe so the value is processed correctly by Apple.
If something can’t be edited in the Apple Business web portal, you’ll be unable to edit it using the
.tsvfile.If you add columns that aren’t recognized by Apple, they’re ignored during processing.
Edit locations template content list
Content category | Type / Character limits | Description | Example | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Brand Reference ID | Required: Yes Character limit: NA | The Brand Reference ID is a unique identifier combining your brand name and country. When you add locations to a specific brand, ensure the Brand Reference ID and Brand ID remain exactly as provided in the downloaded template. Important: Don’t modify them. Copy both values into every row for each new location you add. | Melard_US | ||||||||
Brand ID | Required: Yes Character limit: NA | The Brand ID is a unique identifier. When you add locations to a specific brand, ensure the Brand Reference ID and Brand ID remain exactly as provided in the downloaded template. Important: Don’t modify them. Copy both values into every row for each new location you add. | 12345678901234567890 | ||||||||
Location ID | Required: Yes Character limit: NA | Don’t change this value or another location may get unintended edits. | NA | ||||||||
Display Name | Required: Yes Character limit: 255 | Needs to match the display name. | Melard Clothing | ||||||||
Display Name Language | Required: Yes Character limit: 5 | Needs to be the language code. See Language list. | en-US | ||||||||
Alt Language|Name | Required: No Character limit: 200 | Needs to be the language code and an alternate or former name that customers might search for. For example, after a rebrand. | When there is only one additional name, use (for example): es-US;Brand Cafetería When there is more than one additional name, (for example): es-US;Brand Cafetería|es-MX;Brand Cafetería | ||||||||
Alt Language|About Description | Required: No Character limit: 500 | A translated version of the About Location content for regions with more than one commonly used language. | When there is only one additional About Description, use (for example): en-US;Your first stop for morning coffee. When there is more than one additional About Description, use (for example): en-US;Fresh daily pastries and espresso.|es-US;Su primera parada para el café de la mañana. Pasteles frescos diarios y espresso. | ||||||||
Location Address Country Name | Required: Yes Character limit: 2 | The approved two-letter country code for the country of the location. | US | ||||||||
Address Line 1 | Required: Yes Character limit: 2-200 | The official street address of the location. | 123 Main Street | ||||||||
Address Line 2 | Required: No Character limit: 200 | A suite, floor, or unit number of the location. | Building 5 | ||||||||
Address City | Required: Yes Character limit: 255 | The full name city of the location (not an abbreviation). | Cupertino | ||||||||
Address Sub-locality / Neighborhood / Village | Conditional: On country or region requirements. Character limit: 255 | The sub-locality, neighborhood, or village of the location. Mandatory for locations in the following seven countries: Austria (AT), Brazil (BR), Mexico (MX), New Zealand (NZ), Portugal (PT), Türkiye (TR), and United States (US). | Kadıköy | ||||||||
Address State or Region | Conditional: On country or region requirements. Character limit: 255 | The full name of the state or region of the location. | United States: Needs to be the full name, for example, California. Can be empty only for countries where it’s not required. | ||||||||
Address Postal Code | Required: Yes Character limit: 10 | The postal code of the location. | 95014 | ||||||||
Address Coordinates | Required: No Character limit 1: 2-3 numbers plus a comma Character limit 2: 5 decimal places also required | The longitude and latitude of the location, centered directly on the building. | 37.32496,122.01582 | ||||||||
Normal Hours | Required: Yes Character limit: See Example | Normal operating hours of the location. Normal Hours is a free-text field. You don’t need to follow a strict format, Apple interprets your input automatically. Be as clear as possible when entering hours. If Apple can’t interpret your input with sufficient confidence, your location will still be updated for all other fields but you’ll receive a warning in your processing report and you’ll need to update the hours manually in that location’s Info section in Apple Business. See Manage hours. | Mon-Fri 9am-5pm, Sat 10am-3pm, Sun closed | ||||||||
Temporary Hours | Required: No Character limit: See Example | Hours of the location for adjusted schedules or closures during holidays, maintenance, or other occasions. Temporary Hours is a free-text field. You don’t need to follow a strict format, Apple interprets your input automatically. Be as clear as possible when entering hours. If Apple can’t interpret your input with sufficient confidence, your location will still be updated for all other fields but you’ll receive a warning in your processing report and you’ll need to update the hours manually in that location’s Info section in Apple Business. See Manage hours. | Dec 25: Closed, Dec 31: 9am-2pm | ||||||||
Service Hours | Required: No Character limit: See Example | Special service hours of your location. Service Hours is a free-text field. You don’t need to follow a strict format, Apple interprets your input automatically. Be as clear as possible when entering hours. If Apple can’t interpret your input with sufficient confidence, your location will still be updated for all other fields but you’ll receive a warning in your processing report and you’ll need to update the hours manually in that location’s Info section in Apple Business. See Manage hours. | Drive-through: Mon-Sun 7am-10pm | ||||||||
Phone Number | Required: Yes Character limit: 8-15 digits | The plus sign (+), country code ,and public phone number of the location. See Add a phone number. | +18885551212 | ||||||||
Website | Required: No Character limit: 255 | The URL of the location’s website, Facebook, Instagram, or Tik Tok page. Not permitted: Third-party websites not owned or operated by your organization’s brand. See Add a website. | https://www.melardclothing.com | ||||||||
Location Photos | Required: No Character limit: NA Other: A maximum of 20 photos per upload and 100 photos per location. | The URLs of each photo of the location, separated by a pipe (|). The URLs need to be publicly accessible, resolve to a domain name, IPv4 or IPv6 address, point to point to the largest available version of the image, and can’t be malformed. Note: Photo captions and alt text aren’t currently supported. | https://static.melardclothing.com/photos/cafe_1.jpg|https://static.melardclothing.com/photos/cafe_2.jpg | ||||||||
App Store URL | Required: No Character limit: NA | The official App Store app URL for your brand. It also needs to be available in the country or region where your brand operates. See Add your app. | https://apps.apple.com/app/id0123456789 | ||||||||
Primary Category | Required: Yes Character limit: NA | The primary category of the location. See Add your category. | Clothing store | ||||||||
Additional Category | Required: No Character limit: NA Other: Maximum 19 additional | An optional secondary category of the location. There is a maximum of 19 additional categories per location. See Add your category. | Ice Cream Shop|Bakery | ||||||||
Good To Know | Required: No Character limit: NA | Attributes about the location, separated by a pipe (|). Only values associated with the primary category are permitted. See the “Good to Know” reference file that was downloaded in the ZIP file and Manage “Good to Know” attributes. | Wheelchair Accessible|Contactless Payments|Free Wi-Fi|Outdoor Seating | ||||||||
Status | Required: Yes Character limit: Fixed list of values | Can be set to OPEN, OPENING_SOON, TEMPORARILY CLOSED, PERMANENTLY CLOSED, or UNCLAIM. If a location’s status changes to Closed or Unclaim, the following occurs:
See Manage status. | PERMANENTLY CLOSED | ||||||||
Temporarily Closed From | Conditional: Required if Status is set to temporarily closed. Character limit: 10 Other: Needs to be in the ISO 8601 YYYY-MM-DD format. | Initial date when the location is temporarily closed. | 2026-12-01 | ||||||||
Temporarily Closed Until | Conditional: Required if Status is set to temporarily closed. Character limit: 10 Other: Needs to be in the ISO 8601 YYYY-MM-DD format. | Last date when the location is temporarily closed. | 2027-01-31 | ||||||||
Permanently Closed Date | Conditional: Required if Status is set to permanently closed. Character limit: 10 Other: Needs to be in the ISO 8601 YYYY-MM-DD format. | Initial date when the location is permanently closed. | 2027-07-01 | ||||||||
Opening Soon Date | Conditional: Required if Status is set to opening soon. Character limit: 10 Other: Needs to be in the ISO 8601 YYYY-MM-DD format. | The Opening Soon Date can be up to six months from the current date. | 2027-08-05 | ||||||||