Multi-Step Programs
Multi-Step Programs
Required Role: OWNER, EMPLOYEE
Plan Required: PROFESSIONAL
Create comprehensive multi-step treatment programs, schedule applications throughout the season, and track program progress for your customers.
Overview
Multi-Step Programs allow you to create structured treatment plans with multiple scheduled applications. Perfect for seasonal programs, fertilization schedules, weed control programs, and other multi-visit services.
Getting Started
Before creating programs, ensure you have:
- Products set up in Chemical Catalog (see Chemical Catalog)
- Customers and properties created (see Customer Management)
- Understanding of treatment schedules you want to offer
Creating Programs
Step-by-Step: Create a New Program
- Navigate to Multi-Step Programs in the sidebar

- Click "New Program" or the plus icon

- Enter program details:

- Program Name: Name of the program (e.g., "Spring Fertilization Program")
- Description: What the program includes
- Duration: How long the program runs (e.g., "Season", "12 months")
- Target Turf Type: Type of grass (if applicable)
- Add program steps:

- Click "Add Step"
- Step Name: Name of this step (e.g., "Pre-Emergent Application")
- Product: Select product from catalog
- Application Rate: Rate to apply
- Timing: When to apply (e.g., "Early Spring", "Every 6 weeks")
- Notes: Special instructions
- Repeat for each step
- Set pricing:

- Total Program Price: Price for entire program
- Per Application Price: Price per application (optional)
- Click "Save Program"

Program Information
- Program Name: Descriptive name
- Description: What's included in the program
- Duration: How long program runs
- Target Turf: Grass types this program is for
- Steps: Individual applications in the program
- Pricing: Program pricing structure
Program Steps
Each program consists of multiple steps (applications).
Adding Steps
- When creating or editing program

- Click "Add Step"

- Configure step:

- Step Name: Name of application step
- Step Number: Order in program (1, 2, 3, etc.)
- Product: Product to use (from catalog)
- Application Rate: How much to apply
- Timing: When to apply
- Notes: Instructions for this step
- Add multiple steps

- Reorder steps as needed

Step Timing
Configure when each step occurs:
- Specific Date: Exact date to apply
- Relative Timing: "Week 1", "Every 4 weeks", etc.
- Seasonal: "Early Spring", "Late Fall", etc.
- Trigger-Based: After previous step completion
Assigning Programs to Customers
Assign programs to customer properties.
Step-by-Step: Assign Program
- Open the program detail page

- Click "Assign to Property" or go to customer property

- Select customer and property

- Set start date for program

- Configure schedule:

- Program steps are scheduled based on start date
- Adjust individual step dates if needed
- Click "Assign Program"

Program Assignments
Once assigned:
- Program steps are scheduled as jobs
- Each step becomes a scheduled application
- Track completion of each step
- View program progress
Tracking Program Progress
Monitor program completion and status.
Viewing Program Status
- Open program assignment

- View "Progress" section

- See status of each step:

- Scheduled: Step is scheduled
- Completed: Step has been completed
- Pending: Step is upcoming
- Overdue: Step is past due
Completing Program Steps
- When completing a job for a program step

- Mark job as completed

- Program step is automatically marked complete

- Next step is scheduled (if applicable)

- Progress updates automatically

Program Scheduling
Programs automatically schedule application jobs.
Automatic Scheduling
- Steps are scheduled based on program timing
- Jobs are created for each step
- Jobs are linked to the program
- Schedule adjusts based on start date
Manual Scheduling
- Open program assignment

- Click on step

- Adjust scheduled date

- Save changes

- Job date updates

Common Tasks
Editing Programs
- Open program detail page

- Click "Edit" button

- Update program details or steps

- Click "Save"

- Note: Changes may affect future assignments

Duplicating Programs
- Open program detail page

- Click "Duplicate" or menu option

- New program created with same steps

- Edit as needed

- Save

Viewing Program Assignments
- Open program detail page

- Navigate to "Assignments" tab

- See all properties with this program

- View status of each assignment

Ending Program Early
- Open program assignment

- Click "End Program" or "Cancel"

- Confirm cancellation

- Remaining steps are cancelled

- Completed steps remain in history

Troubleshooting
Program steps not scheduling
- Check start date: Ensure program start date is set
- Verify timing: Review step timing configuration
- Check assignments: Ensure program is assigned to property
- Review schedule: Check if dates are in the past
Can't assign program
- Check customer: Ensure customer and property exist
- Verify permissions: Only OWNER and EMPLOYEE can assign
- Check program: Ensure program is saved and active
- Review dates: Check if dates are valid
Steps not completing
- Check jobs: Ensure related jobs are marked complete
- Verify links: Check that jobs are linked to program steps
- Review status: Check step status manually
- Refresh page: Try refreshing to update status
Program progress not updating
- Refresh page: Status may need page refresh
- Check jobs: Verify jobs are being completed
- Review links: Ensure jobs are properly linked
- Wait a moment: Updates may take a moment to process
Can't edit program
- Check assignments: Programs with active assignments may have restrictions
- Verify permissions: Only OWNER and EMPLOYEE can edit
- Create new: Consider duplicating and creating new version
Related Articles
- Chemical Catalog - Products used in programs
- Chemical Applications - Recording applications
- Job Scheduling - Jobs created from programs
- Customer Management - Assigning programs to properties
Best Practices
- Plan ahead: Design programs before the season starts
- Be specific: Clearly define each step and timing
- Use products: Link to products from catalog for consistency
- Document timing: Clearly specify when each step occurs
- Set pricing: Establish clear program pricing
- Track progress: Regularly review program completion
- Adjust as needed: Modify programs based on results
- Communicate: Keep customers informed of program schedule
- Review results: Evaluate program effectiveness
- Update annually: Review and update programs each season