Most organizations using Awell work with two environments:
Sandbox – where you build, test, and validate your care flows.
Production – where you Orchestrate care flows with real patients.
Workflow overview
The recommended workflow is simple:
Build in Sandbox → Promote to Production
You’ll start by building and testing your care flow in Sandbox. Once it’s ready, you can promote it to Production.
How to promote a care flow
Navigate to the Home space in the app switcher of your Sandbox enviromnent
Select the ⚙️ Settings menu on your left-hand side
Switch to the 'Promotion' tab
Follow the on-screen instructions
Impact on integrations
If you have integrations that rely on care flow identifiers—like pathway definition IDs or data point IDs — there’s no need to worry. When you promote care flows to Production, these identifiers remain unchanged, allowing you to build and maintain your integrations in Production using the same logical IDs from Sandbox.
A couple of important notes
Promotion will copy the current working version of your care flow from Sandbox to Production, not the latest published version.
Promoting a care flow does not automatically publish it to Production. You’ll still need to manually publish it in the Production environment—this ensures you maintain full control over when it's ready for patient enrollment!
View-only mode in Production
When you open a promoted care flow in Production, it will be in view-only mode by default. This is intentional – it ensures that edits are always made in Sandbox and then promoted.
That said, direct edits in Production are allowed (for example, to apply a hotfix), but you must remember to replicate those changes manually in Sandbox to avoid losing them later.
⚠️ Making direct edits in Production can cause your environments to become out of sync. These changes will be overwritten the next time you promote from Sandbox unless you replicate your changes manually in Sandbox.
👀 tip: use our Go-Live Checklist to make sure everything's set. Ready to roll? Hit Publish to take your care flow live in Production!