# About Locations

With the Locations API, Wix users can define multiple physical locations for their business. This allows them to set individual opening hours for each location.

The Locations API allows you to:

+ [Get](fallback::https://github.com/wix-private/sdk-manual-docs/blob/master/public-sdk/business-tools/Locations/business-tools/locations/get-location*original::business-tools/locations/get-location), [list](fallback::https://github.com/wix-private/sdk-manual-docs/blob/master/public-sdk/business-tools/Locations/business-tools/locations/list-locations*original::business-tools/locations/list-locations), and [query](fallback::https://github.com/wix-private/sdk-manual-docs/blob/master/public-sdk/business-tools/Locations/business-tools/locations/query-locations*original::business-tools/locations/query-locations) existing locations.
+ [Create](fallback::https://github.com/wix-private/sdk-manual-docs/blob/master/public-sdk/business-tools/Locations/business-tools/locations/create-location*original::business-tools/locations/create-location), [update](fallback::https://github.com/wix-private/sdk-manual-docs/blob/master/public-sdk/business-tools/Locations/business-tools/locations/update-location*original::business-tools/locations/update-location), and [archive](fallback::https://github.com/wix-private/sdk-manual-docs/blob/master/public-sdk/business-tools/Locations/business-tools/locations/archive-location*original::business-tools/locations/archive-location) locations.
+ [Set a default location](fallback::https://github.com/wix-private/sdk-manual-docs/blob/master/public-sdk/business-tools/Locations/business-tools/locations/set-default-location*original::business-tools/locations/set-default-location) that is reflected in the site properties.

Learn more about how Wix users can manage their [location-specific bookings](fallback::https://support.wix.com/en/article/wix-bookings-offering-services-at-multiple-locations).

## Use cases
- [Set up a new main business location](fallback::https://dev.wix.com/docs/sdk/backend-modules/business-tools/locations/sample-flows#set-up-a-new-main-business-location)

## Before you begin
It’s important to note the following points before starting to code:

+ Locations can't be deleted. Instead, you can archive a location using [Archive Location](fallback::https://github.com/wix-private/sdk-manual-docs/blob/master/public-sdk/business-tools/Locations/business-tools/locations/archive-location*original::business-tools/locations/archive-location). Archiving is permanent; archived locations can't be unarchived.
+ The default location can't be archived.
+ The [Update Location](fallback::https://github.com/wix-private/sdk-manual-docs/blob/master/public-sdk/business-tools/Locations/business-tools/locations/update-location*original::business-tools/locations/update-location) method completely overrides an existing location. Currently, you can't partially update a location.
+ Currently, the location type is just informational and doesn't affect a location's functionality.
+ The `INACTIVE` location status isn't currently supported.
+ The [Wix Bookings API](fallback::https://dev.wix.com/docs/sdk/backend-modules/bookings/introduction) doesn't support the `businessSchedule` object.
  
## Terminology

+ **Default location:** Location reflected in the site properties. This location is used on invoices.
+ **Type:** Describes whether a location is an office, reception, branch or the headquarters.
+ **Status:** Indicates whether a location is `ACTIVE` or `INACTIVE`.
+ **Business Schedule:** Describes the location's regular and exceptional opening hours.
+ **Period:** Regular, weekly opening hours of the location.
+ **Special Hour Period:** Exception to the location's regular hours. The location can be either open or closed during the Special Hour Period.

@package_metadata:@wix/business-tools

To use the Locations API, install the `@wix/business-tools` package.

#### Install the package

Follow the installation instructions for your development environment.

| Development environment | Installation method |
|--|--|
| Wix sites (editor or IDE) | Use the [package manager](fallback::https://dev.wix.com/docs/develop-websites/articles/coding-with-velo/packages/work-with-npm-packages-in-the-editor). |
| Wix sites (local IDE) | Run `wix install @wix/business-tools` using the [Wix CLI](fallback::https://dev.wix.com/docs/develop-websites/articles/coding-with-velo/packages/work-with-npm-packages-with-the-wix-cli).|
| Blocks apps | Use the same installation method as Wix sites. |
| CLI and self-hosted apps | Run `npm install @wix/business-tools` or `yarn add @wix/business-tools`. |
| Headless sites and apps | Run `npm install @wix/business-tools` or `yarn add @wix/business-tools`. |

#### Import the package

To import the package in your code:

```js
import { locations } from '@wix/business-tools'
```

# Sample use cases & flows: Locations


This article shares a possible use case for your implementation, as well as an example flow that supports it.
You're certainly not limited to this use case, but it can be a helpful jumping off point as you plan your implementation.


## Set Up a New Main Business Location

You can help Wix users create a new business location, set it as default, and update the opening hours for a location.

1. Call [Create Location](fallback::https://dev.wix.com/docs/sdk/backend-modules/business-tools/locations/create-location).

2. Set the new location as **default** by calling [Set Default Location](fallback::https://dev.wix.com/docs/sdk/backend-modules/business-tools/locations/set-default-location).

3. List all existing locations by calling [List Locations](fallback::https://dev.wix.com/docs/sdk/backend-modules/business-tools/locations/list-locations).

   > **Note:** Make sure to extract the relevant locations’ IDs from the response and save it for future calls.

4. Update a location's opening hours by calling [Update Location](fallback::https://dev.wix.com/docs/sdk/backend-modules/business-tools/locations/update-location).

   > **Note:** Currently, it isn't possible to partially update a location. Therefore, you'll need to specify the full location object when making the call.

addTypeToLocation( )