Scheduled Flows

Flowguard allows you to schedule your test flows to run automatically at regular intervals. This ensures your website is continuously tested without manual intervention.

Pro Feature

Scheduled flows require a Pro license. See License & Activation for details.

Why Schedule Flows?

Automated scheduling provides several benefits:

• Continuous Testing - Catch issues before your users do
• After-Hours Monitoring - Tests run even when you're not working
• Regression Detection - Quickly identify when updates break functionality
• Peace of Mind - Know your critical flows are being tested regularly

Schedule Options

Flowguard offers flexible scheduling intervals:

Schedule	Interval	Best For
Every 30 Minutes	30 min	Critical checkout flows, high-traffic sites
Every Hour	1 hour	Important forms, authentication flows
Every 6 Hours	6 hours	Standard testing, balanced approach
Every 12 Hours	12 hours	Daily routines, less critical flows
Once Daily	24 hours	Comprehensive site checks
Once Weekly	7 days	Low-priority flows, smoke tests

Setting Up Scheduled Flows

Method 1: Global Schedule (All Active Flows)

Set up a schedule that runs all your active flows automatically:

1. Go to Flowguard > Settings
2. Click the Auto Run tab
3. Find the Scheduled Runs section
4. Toggle Enable Scheduled Runs to ON
5. Select your preferred schedule interval
6. Click Save Settings

All flows marked as "Active" will run at the scheduled times.

Method 2: Individual Flow Schedules

Set up a custom schedule for a specific flow:

1. Go to Flowguard > Flows
2. Click on the flow you want to schedule
3. In the Flow Editor, open Flow Settings
4. Find the Schedule section
5. Toggle Enable Schedule to ON
6. Choose to use the global schedule or set a custom one
7. If custom, select your preferred interval
8. Save the flow

TIP

Individual schedules override the global schedule for that specific flow.

Understanding Schedule Behavior

When Flows Run

Scheduled flows begin execution at the specified intervals, starting from when you enable the schedule. For example:

• Enable at 2:00 PM with "Every Hour" = Next run at 3:00 PM
• Enable at 2:00 PM with "Every 6 Hours" = Next run at 8:00 PM

What Happens During Execution

When a scheduled run triggers:

1. Flowguard checks which flows should run
2. Each flow executes in sequence
3. Results are saved to each flow's history
4. If a flow fails, notifications are sent (if enabled)
5. The dashboard updates with new results

Viewing Next Run Time

To see when flows will next run:

1. Go to Flowguard > Settings > Auto Run
2. Look for "Next scheduled run" information
3. The time is displayed in your local timezone

Or check via the REST API:

GET /wp-json/flowguard/v1/cron/schedule-info

Email Notifications

Get notified when scheduled flows fail:

Enabling Notifications

1. Go to Flowguard > Settings
2. Click the Notifications tab
3. Toggle Flow Failure Alerts to ON
4. Enter your email address (or leave blank for admin email)
5. Save settings

What's Included in Alerts

Failure notification emails include:

• Flow name that failed
• Error message and details
• Which steps failed
• Execution timestamp
• Link to view full results in WordPress

Example Email

Subject: [Your Site] Flow Test Failed: Login Form Test

Hello,

A Flowguard test has failed on your website.

---

Flow: Login Form Test
Site: Your Website
URL: https://yoursite.com
Time: December 27, 2025 10:30 AM

Error:
Element not found: #login-button

Failed Steps:
  - Click Login Button: Element not found

Execution Time: 12 seconds

---

You can view the flow details here:
https://yoursite.com/wp-admin/admin.php?page=flowguard#/flows/123

---
This is an automated message from Flowguard.
You can disable these alerts in Flowguard > Settings > Notifications.

Best Practices

Choose Appropriate Intervals

• Critical flows (checkout, login): Every 30 minutes to 1 hour
• Important flows (contact forms): Every 6-12 hours
• Routine checks (navigation, links): Daily or weekly

Keep Flows Focused

Shorter, focused flows:

• Execute faster
• Are easier to debug when they fail
• Provide more specific failure information

Monitor Results Regularly

Even with automation:

• Check the dashboard weekly
• Review failed flow patterns
• Update flows when your site changes

Test After Major Updates

After WordPress core, theme, or plugin updates:

1. Run all flows manually first
2. Check for failures due to changed elements
3. Update selectors if needed
4. Resume scheduled runs

Use Test Mode

Always keep Test Mode enabled for scheduled runs to prevent:

• Accidental form submissions
• Real email sending
• Database modifications

Troubleshooting

Scheduled Flows Not Running

Check 1: WordPress Cron

Flowguard uses WordPress cron. Ensure it's working:

// Add to wp-config.php if cron is disabled
define('DISABLE_WP_CRON', false);

If your host doesn't support WordPress cron, set up a system cron:

# Run every minute
* * * * * wget -q -O - https://yoursite.com/wp-cron.php?doing_wp_cron > /dev/null 2>&1

Check 2: License Status

Scheduled flows require an active Pro license:

1. Go to Flowguard > License
2. Verify your license is active
3. Reactivate if needed

Check 3: Schedule Is Enabled

1. Go to Flowguard > Settings > Auto Run
2. Verify "Enable Scheduled Runs" is ON
3. Check that at least one flow is Active

Flows Running But Not Completing

Check 1: Execution Mode

Verify your execution mode is properly configured:

1. Go to Flowguard > Settings > Execution
2. If using Local API, ensure the server is running
3. If using Remote, check your connection

Check 2: Server Resources

Long-running flows may timeout:

• Increase PHP max execution time
• Increase WordPress memory limit
• Check for resource constraints

Check 3: Flow Timeout Settings

Individual flows may have timeout settings:

1. Open the flow in the editor
2. Check Flow Settings > Timeout
3. Increase if flows are timing out

Notifications Not Arriving

Check 1: Email Settings

1. Go to Flowguard > Settings > Notifications
2. Verify notifications are enabled
3. Check the email address is correct

Check 2: WordPress Email

Test if WordPress can send emails:

• Install a mail testing plugin
• Check your SMTP configuration
• Review server mail logs

Check 3: Spam Folder

Check your spam/junk folder for Flowguard emails.

Run History

Viewing History

Each scheduled run is recorded in the flow's history:

1. Go to Flowguard > Flows
2. Click on any flow
3. View the execution history showing:
   • Timestamp of each run
   • Pass/fail status
   • Execution duration
   • Trigger type (scheduled vs manual)

History Retention

By default, Flowguard keeps the last 10 runs per flow. Configure this in:

Flowguard > Settings > Auto Run > History Count

REST API for Schedules

Developers can interact with schedules via the REST API:

Get Schedule Info

GET /wp-json/flowguard/v1/cron/schedule-info

Response:

{
  "enabled": true,
  "schedule": "daily",
  "schedule_label": "Once Daily",
  "next_run": "2025-12-28T00:00:00+00:00",
  "next_run_human": "12 hours",
  "flow_schedules": {
    "123": {
      "schedule": "hourly",
      "next_run": "2025-12-27T13:00:00+00:00"
    }
  }
}

Get Schedule Options

GET /wp-json/flowguard/v1/cron/schedule-options

Response:

[
  {"value": "flowguard_every_30_minutes", "label": "Every 30 Minutes"},
  {"value": "hourly", "label": "Every Hour"},
  {"value": "flowguard_every_6_hours", "label": "Every 6 Hours"},
  {"value": "flowguard_every_12_hours", "label": "Every 12 Hours"},
  {"value": "daily", "label": "Once Daily"},
  {"value": "flowguard_weekly", "label": "Once Weekly"}
]

Related Documentation

• Running Flows - Manual flow execution
• Settings - Configure all Flowguard settings
• License & Activation - Enable Pro features
• Test Mode - Protect against side effects