# Locations

Locations are used to define where your resources are at. Most of the time, when creating a resource, you'll need to select where the resource is located. This is to help users find a resource near to where they are.

{% hint style="info" %}
When searching for resources, users can filter by location. Defining a precise location for your resources will make it easier for users who may have specific requirements.
{% endhint %}

### Parent and child locations

Depending on the location, there can be up to 3 location levels. These levels are organised in a hierarchy with parent and child locations. In most cases, the resource should be located at the lowest location level.

\
Here are 2 examples:

<figure><img src="https://1434314168-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKh3QAdDkZRpCzNg4Hjve%2Fuploads%2FYMIgGsLfYjYaYe2KPSAN%2FLocation%20structure.png?alt=media&#x26;token=cf33bf5e-75da-4dd5-8805-0cc46069bd0c" alt="Example A: A hierarchical diagram with 4 levels, 3 representing the location structure and the fourth level showing a resource. The first level shows Headquarters. The second level shows Block 10. The third level shows Level 3. The fourth level shows the resource Meeting Room 10-39.  Example B:  A hierarchical diagram with 3 levels, 2 representing the location structure and the third level showing a resource. The first level shows TPY Building. The second level shows Level 10. The third level shows the resource 1029 Andes."><figcaption></figcaption></figure>

In example A, `Meeting Room 10-39` is located at `Level 3` of `Block 10` within the `Headquarters` compound. In this case:

* `Level 3`’s parent location is `Block 10`
* `Block 10`’s parent location is `Headquarters`
* `Headquarters` has no parent location
* `Block 10` is a child location of `Headquarters`
* `Level 3` is a child location of `Block 10`

In example B, `1029 Andes` is located at `Level 10` of `TPY Building`. This means:

* `Level 10`’s parent location is `TPY Building`
* `TPY Building` has no parent location
* `Level 10` is a child location of `TPY Building`

### Shared locations

A location can be shared among multiple agencies. For example, if a location is shared among MOF, MTI, and PSD, admins of these 3 agencies can create resources within the same location.

{% hint style="info" %}
Shared locations are different from [shared resources](https://help-admin.rbs.dwp.gov.sg/knowledge-base/resources/shared-resources). If you want to share resources with users of another agency, edit the resource to enable sharing.
{% endhint %}

### Viewing and editing locations

To view the locations available for your agency, select **Locations** on the side navigation bar.

<figure><img src="https://1434314168-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKh3QAdDkZRpCzNg4Hjve%2Fuploads%2FUSEIKrjisXTW5WCGK0qt%2FLocations-1.png?alt=media&#x26;token=4c9dd8c3-d452-4537-9a9b-4682b6416974" alt="Screenshot of the RBS admin portal, showing the step to select Locations on the side navigation bar."><figcaption></figcaption></figure>

You’ll see a table with all the locations you can create resources in. From this table, you can look for and edit an individual location.

The name of each location is displayed along with its parent location in the following format: `Location Level 1`, `Location Level 2`, `Location Level 3`.&#x20;

For example, if the location name is listed as `Queenstown Public Library, Level 1`, it means that the parent location is `Queenstown Public Library` and the child location is `Level 1`.

<div align="left"><figure><img src="https://1434314168-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKh3QAdDkZRpCzNg4Hjve%2Fuploads%2FuVLhTYllepIkL65Ffxqc%2FLocation%20name.png?alt=media&#x26;token=8f8edc3c-d6be-4089-bbee-39adf12becee" alt="A hierarchical diagram with 2 levels of locations. The first level is the parent location and it shows Queenstown Public Library. The second level is the child location and it shows Level 1.  "><figcaption></figcaption></figure></div>

{% hint style="info" %}
When you edit a location, you are editing it for all the agencies that have access to the location.
{% endhint %}

### Creating locations

You can create a location for your resources. If necessary, the location that you create can be shared with other agencies.

Here are some tips for creating locations:

* **Check that the location does not already exist**\
  If this is a location that’s shared with other agencies, admins of the other agencies may have already created it. <br>
* **When entering the name of the location, do not include the parent location.** \
  For example, the name should be `Level 1` instead of `Queenstown Public Library, Level 1`.<br>
* **Select the correct parent location**

  For example, if you’re creating Level 1 of Queenstown Public Library, make sure\
  you select `Queenstown Public Library` as the parent location. If there is no parent&#x20;

  location, select **None**.<br>
* **If it’s a shared location, do give all the relevant agencies access.**&#x20;

  This prevents duplicate locations, which makes it harder for users to find\
  resources near them.

### Types of location

There are 3 types of location:

* Building (for example: CPIB, Revenue House)
* Common Area (for example, Braddell Campus, Left Wing)&#x20;
* Floor (for example, Level 10)

When creating a location, you’ll be asked to select a type that best describes it. This allows you to filter by location type when viewing locations.

<figure><img src="https://1434314168-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKh3QAdDkZRpCzNg4Hjve%2Fuploads%2FFN5fJesqOz3prGYsc8Rr%2FLocations-2.png?alt=media&#x26;token=bc2b869c-904a-430b-a584-02cdfda85f01" alt="Screenshot of the RBS admin portal, showing the Location type filter on the Locations screen."><figcaption></figcaption></figure>