Prescriptions can be used to prescribe medicine to patients.

A Prescription can be used to:

  • Issue medicine to a patient

Viewing Prescriptions

To use prescriptions, ensure that your store is set to Dispensary mode (see the virtual stores documentation for how to do this).

Open the Prescriptions Menu

Choose Dispensary > Prescription in the navigation panel.

Go to Prescriptions

You will be presented with a list of Prescriptions (if you don't see any, you are probably just starting!).

From this screen you can:

  • View a list of Prescriptions
  • Create a new Prescription
  • Export Prescription to a .csv file

Prescription list

  1. The list of Prescriptions is divided into 5 columns:
NameName of the Patient
StatusCurrent Status of the prescription
NumberReference Number of the precription
CreatedCreation date of the prescription
CommentComment for the prescription
  1. The list can display a fixed number of prescriptions per page. On the bottom left corner, you can see how many prescriptions are currently displayed on your screen.


  1. If you have more prescriptions than the current limit, you can navigate to the other pages by tapping on the page number or using the right of left arrows (bottom right corner).


  1. You can also select a different number of rows to show per page using the option at the bottom right of the page.

Rows per page

Search by Patient Name

You can filter the list of prescriptions by patient name. This can be useful if you're looking for one particular prescription!

Type the name of a patient in the Search by name field (on the left, just above the list headers). All the prescriptions for this patient will appear in the list.

Search by name

Exporting Prescriptions

The list of Prescriptions can be exported to a comma separated file (csv). Simply click the export button (on the right, at the top of the page)

Export button

and the file will be downloaded. The export function will download all Prescriptions, not just the current page, if you have more than 20 of them. Prescriptions are exported using sort order selected in the table, though of course you could easily sort the list in Excel or whatever you open the .csv file with!

Delete a Prescription

You can delete a prescription from the Prescription list.

  1. Select the prescription that you want to delete by checking the box on the left end of the list. You can select more than one prescription to be deleted. You can even select them all using the master checkbox in the list headers.

  2. Open the Select dropdown (top right corner, above the list) and select Delete selected lines.

  3. A notification confirms how many prescriptions were deleted (bottom left corner).

You can only delete Prescriptions with a status NEW.

Prescription list: delete

Creating a Prescription

  1. Go to Dispensary > Prescriptions.

  2. Press the New Prescription button, in the top right corner

New Prescription

  1. A new window Patients opens, inviting you to select a patient.

Select a Patient

  1. In the Patients window, you will be presented with a list of available patients. The patients list will load the first 100 patients and prompt you to refine your search by typing as much of the patient's name or code as you can.
In below example, we are prescribing medicine to Luna Lovegood.


  1. Your Prescription is automatically created once you click on the patient in the dropdown list.
If everything went well, you should see the name of your patient in the top left corner and the status should be NEW

Prescription: created

Edit the Patient Name

If you have selected the wrong patient, you can change the patient name in the Patient Name field or select one the dropdown list:

Change patient

You may need to type more of the patient's name or code if you have more than 100 patients for the patient's name to show on the dropdown list.

Select the Clinician

Once your Prescription has been created, you can select a clinician from the Clinician dropdown list. Select Clinician

View or edit the Prescription Information Panel

The Information Panel allows you to see or edit information about the Prescription. It is divided into multiple sections:

  • Additional Info
  • Invoice Details

We are planning to add more sections in the future as Open mSupply grows.

How to open and close the Information Panel?

If you are using a large screen, the information panel will be automatically opened for you. However, on an average sized screen, the information panel will be closed by default.

To open the Information Panel, you can tap on the More button, located in the top right corner of the Prescription view.

You can close by tapping on the X Close button, on the top right corner of the information panel.

Open and close the Information Panel

Additional Info

In the Additional Info section, you can:

  • See who created the Prescription (name of the user)
  • View and edit the Prescription color. To edit the color, tap on the coloured circle and select a color from the pop-up
  • Write or edit a comment

Prescription Details

In this section, you will see by default the total selling price of the items listed in the Prescription.

Prescription Status Sequence

The status sequence is located at the bottom left corner of the Prescription screen.

Passed statuses are hightlighted in blue, next statuses appear in grey.

Status Sequence: current status is NEW.
Status Sequence: current status is VERIFIED.

There are 3 status for a Prescription:

NewThis is the first status when you create a prescription.
PickedPrescription is picked and is now ready to give to the patient. Goods are still part of your inventory and prescription can still be edited.
VerifiedThe patient has received their medicine.

If you hover over the status sequence, a prescription history window appears. You can see the date when a perscription was updated from one status to another.

This prescription has been created, picked and verified on 18/08/2023

Prescription status: hover

Cancel and Confirm button

Cancel Button

Tap on the Close button to quit the Prescription view and return to the Prescriptions list.

Confirm Button

The Confirm button updates the status of the prescription. The status which you can confirm depends on the current status of the prescription and follows the sequence shown below.

When managing an Prescription, you can only confirm the Picked and Verified statuses.

Confirm...Current StatusNext Status
Confirm PickedNewPicked
Confirm VerifiedPickedVerified

You don't have to update a prescription to the next status in the sequence. You can choose to skip Confirm Verified and go directly to Confirm Shipped for example.

As demonstrated below, tap on the down arrow of the Confirm button and select the status you want the prescription to be updated to.

Skip Status

Adding lines to a Prescription

Tap on the Add Item button (top right corner).

A new Add Item window opens.

Add Item button

Select an Item

In the Add Item window, you can look up an item by:

  • Reading through the list of available items
  • or by typing some or all of the item name
  • or by typing some or all of an item code

Once your item is highlighted, tap on the name or press Enter.

Alt Text

Once the item is selected, you can see the following information:


  • Item code and name (eg. 030063 Acetylsalicylic Acid 100mg tabs)
  • the available stock quantity for this item (eg. 20,976 units)
  • the item's unit (eg. Tab)
  • Note: The medicine's instruction for use.
Example: For the item *030063 Acetylsalicylic Acid 100mg tabs*, there are 20,976 tabs available.

add item headers

Issue [Quantity] of units in packs of [Pack Size]

In the Issue Quantity field, you can enter the quantity that you want to issue to your patient.

By default, you are invited to issue a quantity of units. However, you have the possibility to issue a quantity of packs instead by changing the value in the second dropdown (Pack Size).

Default value is Any when you are issuing units.

Prescription Issue quantity

List of available batches:

This is a list of batch numbers that you have in store for this item:

  • Batch: Batch number. It is a designation given to products made in the same manufacturing run.
  • Expiry: Expiry date of the batch (format: MM/YYYY)
  • Location: This is the name of the location where the item is stored if your inventory is managed with storage locations
  • Pack Size: Quantity of units per pack
  • On Hold: Indicates whether a batch is on hold or not. You cannot issue a batch that is on hold.
  • In Store (packs): Total number of packs in your store
  • Available (packs): Number of packs available (not already allocated to other shipments)
  • [Unit] Qty Issued: Total quantity of units to be issued
  • Pack Qty Issued: Number of packs to be issued

List of available batch numbers

The batches which are available for selection are shown first and batches which are not (on hold or no stock available) are shown below and in a grey font.

Issue a quantity of units

By default, you are invited to issue a quantity of units, regardless of the pack size (number of units in a pack).

When entering a number in the Issue field, after clicking the Allocate button, the system automatically chooses the batch number(s) with the closest expiry date (First to Expire, First Out or FEFO logic).

In below example, we are issuing 100 units of the item. All 100 units will be taken from the same batch (second row). The first batch was not selected because it is expired.


In this other example, we are issuing 100 units. System selects two batches with different pack sizes.


Issue a quantity of packs

You can decide to issue a quantity of packs. To do this, you can change the value in the Pack Size dropdown.

Let's imagine that you only want to dispense in a pack size of 25 units. You can change the dropdown value from `Any` to `25`.

Alt Text

You are now offered to issue a number of packs of 25 units. Only batch number(s) with a pack size of 25 units can be automatically issued.

In below example, we are issuing 4 packs of 25 units:


If you had previously entered a quantity of units and you switch to a quantity of packs, the quantity of units will automatically be converted into the correct quantity of packs.

Alt Text

When a pack size is selected, stock lines which have a different pack size from the one selected are not available for selection. As such, those rows are listed lower down in the table and are shown in a grey font, in the same way as other unavailable rows.

Manual Allocation

Regardless if you chose to issue a quantity of units or packs, you can always manually change the quantity at the batch number level directly before pressing on OK.

You simply have to enter or edit the quantity in the Packs Qty Issued column.

The values in the Total row will be automatically updated with the new quantity.

When allocating quantities at the batch number level, the quantity you enter is always a quantity of packs.
Manual allocation at the batch number level.

Confirm Item and Quantity

When you are happy with the quantity, you can either press on:

  • the OK button. You are redirected to the Prescription view and your item has been added to the list
  • the OK & Next button to add another item right away
  • the Cancel button if you do not want to add the item to the Prescription any more

Editing a Prescription Line

To edit a prescription line, tap on it. You will be presented with the Edit Item window, which is identical to the Add Item window, except that the item is already chosen.

Edit a Prescription Line

You can edit a prescription line if the prescription has a status lower than Verified.
  1. Open the Prescription you want to edit.

  2. Tap on the line you want to edit. An identical window to Add Item appears. At this stage:

    • Edit the main Issue Quantity field
    • or change the number of packs value at the batch number level
When editing a prescription line, you cannot change the item. You would need to delete the prescription line and create a new one.

Delete a Prescription line

  1. Open the Prescription you want to edit.
  2. Select the line(s) you want to delete by checking the box(es) on the right of the list.
  3. Go to the Actions dropdown menu (top right corner, above the list)
  4. Select the action Delete selected lines

Alt Text

In below example, we are deleting item 030063 - Acetylsalicylic Acid 100mg tabs

Alt Text

You can delete multiple lines at once. Be sure to review what is selected before performing the Delete action.

Processing a Prescription

Confirming Prescription picking

Picking refers to the process where individual items are picked from pharmacy.

Once all items are picked and packed. You can then confirm the picking of the prescription to indicate that it is ready to be dispatched.

To confirm that a prescription has been picked, tap on the Confirm Picked button.

Alt Text

Once picking is confirmed:

  • Prescription status is now PICKED
  • You are now invited to confirm the prescription via the Confirm Verified button

At this stage, you are still able to edit shipment lines, to add items or to delete existing lines.

Verify the Prescription

The last step to prescribe medicine is to verify the prescription.

To verify a prescription, tap on the Confirm Verified button.

Once the prescription has been confirmed:

  • Prescription status is now VERIFIED
  • Goods are no longer part of your inventory
  • You can no longer edit prescription lines
  • You can no longer delete the prescription

Viewing Prescription

Batches are automatically grouped by item when viewing a specific prescription. Use the expand in the table header to expand all grouped rows.

Group by Item

If you do not have enough room on your screen, or simply aren't interested in some of the columns shown, you have the option of hiding which columns are shown in this view.

Click on the Show / hide columns button which is at the top right of the table. This gives a list of the columns available - you can check the columns you want to see. The options chosen are stored for the current browser, so next time you view an Outbound Shipment, you will see the selected columns only. If you have chosen which columns to show, then the button is shown in blue to remind you that there are more columns available.

Hide columns