Manage Locations


Locations are one of the most important building blocks of OpenBoxes. They are used to track where stock came from, where it is, and where it went. There are several different types of locations in Openboxes:

Depot: A depot is a location that can manage stock within Openboxes. Any location that you can enter and see the dashboard is a depot. All of the location in the opening menu are depots:

You should create a location as a depot if, and only if, you have a user who will be actively managing the inventory in that depot. If you will not be managing inventory in that location in OpenBoxes, choose one of the following location types.


Supplier: A supplier is a location that exists only to send stock to other locations. Suppliers do not have a dashboard or inventory. You should create a supplier location to reflect every location that is sending stock to your warehouses, but is not a depot. Usually, a supplier in openboxes is also a supplier in real life, for example However, any location that is sending stock but not managing stock in Openboxes can be a "supplier" in the system.


Dispensary/Ward/Pharmacy: These locations are essentially interchangeable. All exist only to receive stock from Depots. Any location to which you will be sending stock, but not actively receiving or managing inventory in Openboxes, should be created as a ward, dispensary, or pharmacy


View and Search Locations

To access the location list page, hover over Configuration and click “locations”.

A new screen will appears that lists all of the locations in the system.

You can search for a location by name, or filter by location type or location group. You can also click the “export locations” button to see the full list of locations in Excel.

To see more information about a particular location, click the carrot next to the name and press “Show location”

This will bring you to a page with details about the location.

Each of the tabs on this screen shows a list of objects associated with the location. For example, the shipments tab shows a list of all shipments to or from the location. You can click on an item in the list for more details.


Create and Edit Locations


Hover over Configuration and click “locations”.

 On the new screen that appears, click “Add location”.

The new location screen will appear as follows:

  1. Name: Write in the name of the new location

  2. Location Code: Type in a nickname or acronym for this location (optional)

  3. Location Type: Choose depot, supplier, ward, dispensary, or pharmacy.

  4. Location group: Choose which location group you want it to fall under. Learn more about location groups.

  5. Manager: Choose an OB to act as manager of the location (optional)

  6. Background color/ Foreground color: allows you to edit the color that appears on the screen (optional)

  7. Sort Order: The order you want the location to appear in the main menu (optional)

Click save to create the location. But don’t stop there! You need to fill out the other tabs!

Status tab:


  1. Active: Automatically checked. Only uncheck this if you want the location to be hidden to users

  2. Managed locally: Automatically checked. There is no functionality associated with this field yet - leave as-is

  3. Supported activities: “Use default settings” is automatically checked. In most cases, it should be left that way. Below are some common changes to the default settings that you might make (all for depot type locations)

    1. Turn off bin location tracking: remove “pick stock” and “putaway stock” from the supported activities to turn off bin location tracking in this depot

    2. Turn on partial receiving: Add partial receiving to the supported activities in your depot if you want to be able to receive a shipment in part and then receive the rest later. The default is that shipments must be received all at once.

    3. Turn off inventory tracking: If you want a location to be recognized as a depot for filtering purposes, but not appear as a location that users can log into, remove “manage inventory” from the supported activities.


Address tab (optional): Enter the address for the location in this tab. Administrators can configure purchase order printouts and shipping templates to use this address.


Bin Locations: This tab is only for use in depots with bin tracking enabled. Use it to add or remove bin locations within your depot. See more in


Once you have made all of your updates, click save to register your changes.

After you have created you location, you can add a logo that will show in the upper right hand corner of the screen when you log in. You may have noticed that many of the screenshots show a customized location logo like the below:

You can upload a custom logo to your location on the shipment list page:

Find the location you want to add the logo to. Click the carrot net to the name, and choose “upload logo.”

Choose a file from your computer and press upload

When you log in to that location, you will see your logo in the top left corner.


From the location list screen, you can edit any location by either clicking the name of the location, or clicking the carrot next to the name and choosing “edit “location”

From here, you will be redirected to the same set of screens as you saw during the location creation process. Edit the fields you want to change and press save.

Delete and Deactivate

Delete: To delete a location, find the location on the shipment list page. Press the carrot next to the name and choose “Delete Location.”

Please note that if your location has ever been involved in a transaction, it cannot be deleted. This prevents users from accidentally breaking the database by deleting information that is being used in other places in the system. So then what do you do if you can’t delete a location?

Deactivate a location: Deactivating a location makes it unavailable for users to view or select while they are working on OpenBoxes. The location still exists, and may appear in old data from before it was deactivated, but it can’t be seen or used in transfers moving forward. Deactivate locations can be reactivated at any time.

To deactivate a location, go back to the location edit screen and select the status tab:

Uncheck the box next to active and press save. This will deactivate your location.