dispensing:dispensary_mode

This is an old revision of the document!


10.01. Dispensary mode

Dispensary mode allows you to use mSupply to issue medicines to patients. It is ideally suited for pharmacies, clinics, hospital dispensaries, and facilities where medicines are supplied to individual patients.

The particular benefits of using Dispensary mode include:

  • Labels can be printed with:
    • Item description and quantity issued
    • Patient name
    • Prescriber name
    • Directions
    • Institution name
    • More…
  • Use of Dispensary mode depends on your mSupply registration type. Contact Sustainable Solutions if you wish to upgrade your registration.
  • Regardless of mode, each user can only use those functions for which they have permission, according to the permissions set for that user. See Managing Users
  • In client-server versions of mSupply, different users can be logged in in different modes at the same time, allowing you to dispense to patients and supply wards, stores, clients or cost centres simultaneously.
  • Users whose permissions allow them to operate in either Store mode or Dispensary mode may change from one to the other by pressing Ctrl+2 on the keyboard. Re-entry of the user's password is not necessary.

Prior to version 3.5 you controlled dispensary mode for each user, and had to choose File > Edit users…
Now it's a setting for a store.

  1. Click Special > Show stores…
  2. Double-click on the store you want to set to dispensary mode.
  3. Select Dispensary in the drop down list next to the store's code field.
  4. Log out of the store and log in again to activate dispensary mode.

Click Admin > Preferences > Dispensary mode to set preferences.

Important preferences to consider:

  • Ensure the Show direction entry in dispensary box is ticked.
  • Specify what information will be printed on dispensing labels.
  • Specify if you want a receipt to automatically print on labels.
  • Specify if you want mSupply to auto-generate patient codes (alternatively, the user must enter a unique code for each patient).
  • Specify if a prescriber must be entered for each prescription.
  • Specify if you want to be able to receive payments from the prescription window.

What is a "name"?

In mSupply a “name” can be a customer, a supplier, both or neither. A “customer” can be anyone you supply goods to - e.g. another organisation, or a ward in your hospital, or a patient.

Different menus

Some of the menus in dispensary mode have different names. For example, the Customer menu becomes the Patient menu.

But most of the things you can do in store mode are also available in dispensary mode. In fact, the navigator looks much the same. The only difference is the Customers tab, which is renamed to the Patients tab and has a slightly different selection of icons:

The functionality of the common icons is the same as in store mode and applies mostly to customers not patients (a dispensary mode store can still distribute stock to customers (not patients) and handle customers' requisitions). For details of those functions, see the other sections of this guide.

Different windows

The windows displayed are appropriate for dispensing medicines to individual patients.

A patient's dispensing history is maintained and you can also record patient notes (e.g. allergies).



  • Last modified: 2019/11/01 13:46
  • by Emily Porrello