Skip to content

Last modified: March 13, 2025

Product substitution tool

Overview

Use the product substitution tool to replace at-risk products in patient plans. Products are considered at-risk when they’re no longer in our catalog, are on a long-term backorder, or have limited stock and won’t be replenished. The product substitution tool can help ensure that patients can order the products they need.

Tip!

While the product substitution tool helps swap products in active plans, the Plan optimization tool helps to find alternative products that can improve adherence or increase accessibility for your patients.

Navigating to the product substitution tool

Products appear in the product substitution tool when they pose a risk to patient adherence. Only those that have been recommended by you or ordered in the last three months are displayed––you won’t be able to swap products in plans written by another practitioner in your dispensary.

Warning!

Some products don’t have curated substitutions, so the tool defaults to keyword-based search results. This may result in substitutions that aren’t direct ingredient matches.

To go to the Product substitution tool:

  1. In the lower-left hand corner, select your name to open the avatar menu.
  2. Select Product substitution. 
Finding the product substitioner tool

Note:

You can substitute products in plans you’ve created. If the plan was written by another practitioner in your dispensary, they’ll need to make the change.

Substituting at-risk products 

At-risk products are unavailable because they’re back ordered, out of stock, or discontinued. To ensure patient adherence isn’t impacted, consider substituting at-risk products with suggested alternatives.

Tip!

The product subtitution tool can also be accessed from the product display page for an affected item. Click the View plans button on the product display page when you see a warning.

Substituting at-risk products with a similar product

Products can be substituted with similar products curated by Fullscript’s integrative medical advisory team

To substitute an at-risk product with a similar product in the Product substitution tool, find the product you’d like to swap out, then:

  1. Using the tabs at the top of the page, choose between Discontinued products, or Out of stock products. For the following steps, we’re going to find a substitute for a discontinued product.
Choose between the lists of Discontinued or Out of Stock products.
  1. Click View plans next to the product you’d like to create a substitution for.
  2. Select between Individual or Multi-patient plans as applicable.
  1. Find the customer or plan you’d like to provide a replacement product for and click Select replacement. If you’re curating a substitution for multiple patients or plans, use can select them using the check boxes on the left, then click Select bulk replacement.
Using the bulk replacement option for a product substitution.

Note:

If you’re looking to offer a substitution for an Out of stock product, the visible button will say Add substitutes instead of Select replacement.

  1. After clicking Select replacement (or Select bulk replacement), select a replacement product from the list. If you’d like to look for another product, click Search catalog at the bottom of the drawer. You can also launch the Smart product comparisons tool by clicking the Compare button.

Tip!

When setting a replacement for a Discontinued product, you may only choose one new product. In the case of Backordered or Out of Stock products, you can select up to three substitutions.

  1. After you’ve selected a replacement or substitute, click Add instructions at the bottom of the drawer.
Click Add instructions.
  1. Set the dosage instructions for the new product. Optionally, you can also click the Email patients their updated plan checkbox if you’d like us to notify them of your update.
Click the checkbox to notify your patient.
  1. Click Update plan to complete the replacement or substitution.

Substituting at-risk products with a product from the catalog

To substitute an at-risk product with another product from the catalog, find the product you’d like to swap out, then:

  1. Using the tabs at the top of the page, choose between Discontinued products, or Out of stock products. For the following steps, we’re going to find a substitute for an out of stock product.
Choose between the lists of Discontinued or Out of Stock products.
  1. Click View plans next to the product you’d like to create a substitution for.
  2. Select between Individual or Multi-patient plans as applicable.
Choose between individual or Multi-patient plans.
  1. Find the customer or plan you’d like to provide a substitute product for and click Add substitutes. If you’re curating a substitution for multiple patients or plans, use can select them using the check boxes on the left, then click Select bulk substitutes.
Click Select Bulk Substitutes.

Note:

If you’re looking to offer a substitution for an Out of stock product, the visible button will say Select replacement instead of Add substitutes.

  1. Click Search Catalog at the bottom of the substitutions drawer.
Click Search catalog.
  1. Use the catalog features as normal to find products that you’d like to add as substitute products. To add a product as a substitute, click Add as substitute in the product card.
Add as substitute.

Note:

You can add up to three substitutes for a backordered or out of stock products. You can only select one replacement for a discontinued product.

  1. Once you’ve selected all of the substitutes you’d like (up to a maximum of three), click Next in the product substitutes bar at the top of the page.
  2. Set the dosage instructions for the new products. Optionally, you can also click the Email patients their updated plan checkbox if you’d like us to notify them of your update.
Click the checkbox to notify your patient.
  1. Click Update plan to complete the replacement or substitution.

Editing a past substitution

To update a completed product substitution, go to the patient’s profile and locate the plan where you added the substitution. Once you’ve found the plan:

  1. Click the Edit ( ) button.
    Edit a patient plan.
  2. Scroll down to the product with the substitution.
  3. Click the More options ( ) button.
  4. Click Edit substitutes.
    Edit substitutes.
  5. In the product substitutions drawer, click Select to add a substitute, or Remove if you’d like to remove a substitution.
    Removing a previously applied substitute.
  6. When you’re done, click Save.

Note:

It’s not possible to edit a replacement for a discontinued product.

The patient experience

Replacement alerts in plans

In patient plans, a banner is displayed underneath products that have been given a substitute. Patients will still see the original product, and can click the View substitute button to reveal the alternate product.

The Substitute option available banner.
The Substitute option available banner.

Note:

Product substitutions are only available on desktop and in mobile browsers.

Swap alert in past orders

Patients who’ve ordered a product in the past will see a swapped product banner in their order history, at the bottom of any affected order. The original product is displayed, and the swapped product is mentioned and linked to.

A product swap banner in the patient's order history.
A product swap banner in the patient’s order history.
Was this article helpful?