Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


👁 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 “Create “Add location”.



The new location screen will appear as follows:


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

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

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

    1. Example: Dispensary

  4. Location group: Choose which location group you want it to fall under

    1. Example: Lisungwi

    . Learn more about location groups.

  5. Manager: Choose an OB to act as manager of the location . Not required.

    Example: Laura Gould


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

  7. Sort Order: Not required.

  8. Status- Properties: Select whether or not the location is active or inactive, managed locally or remotely.

  9. Status- Supported activities: Select the functionality of the location. In most cases, you will choose “default settings” which will allow the location full functionality.

    1. Note: If you need to select multiple supported activities hold down “CTRL” and “ALT” at the same time and click all relevant entries.

  10. Address: If helpful you can put in the address information for the OB location. Not required.

  11. Once all settings have been determined, click “save”. Your new location is now registeredThe 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 Manage Bin Locations

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.