Skip to main content

Troubleshooting

Common issues and solutions for Maestro Theme Scheduler.

Schedules Not Executing​

Check Timezone Settings​

Problem: Schedules run at wrong times

Solution:

  1. Go to app settings
  2. Verify timezone is correct
  3. Update if needed
  4. Recreate affected schedules

Verify Schedule Status​

Problem: Schedule created but not running

Solution:

  1. Check schedule is activated
  2. Verify start time hasn't passed
  3. Check for conflicting schedules
  4. Review schedule logs

Check Permissions​

Problem: App can't modify theme

Solution:

  1. Verify app has theme write permissions
  2. Re-authorize if needed
  3. Check theme access
  4. Contact support if issues persist

Sections Not Appearing​

Verify Section ID​

Problem: Scheduled section doesn't exist

Solution:

  1. Check section ID is correct
  2. Verify section exists in theme
  3. Update schedule with correct ID
  4. Test with a known section

Check Theme Compatibility​

Problem: Section scheduling doesn't work with theme

Solution:

  1. Verify theme supports section scheduling
  2. Check theme version
  3. Update theme if needed
  4. Contact theme developer

Review Schedule Timing​

Problem: Section appears at wrong time

Solution:

  1. Check schedule start/end times
  2. Verify timezone settings
  3. Review schedule logs
  4. Adjust timing if needed

Performance Issues​

Too Many Active Schedules​

Problem: Store performance degrades

Solution:

  1. Reduce number of active schedules
  2. Consolidate similar schedules
  3. Use batch operations
  4. Optimize schedule timing

Slow Execution​

Problem: Schedules take too long to execute

Solution:

  1. Check store performance
  2. Reduce concurrent schedules
  3. Optimize theme
  4. Contact support if needed

Common Errors​

Permission Errors​

Error: "Insufficient permissions"

Solution:

  1. Re-authorize app permissions
  2. Check admin access
  3. Verify theme permissions
  4. Contact support

Schedule Conflicts​

Error: "Schedule conflict detected"

Solution:

  1. Review conflicting schedules
  2. Adjust timing
  3. Remove duplicates
  4. Consolidate schedules

Theme Errors​

Error: "Theme modification failed"

Solution:

  1. Check theme is not locked
  2. Verify theme version
  3. Test with different section
  4. Contact support

Getting Additional Help​

If you're still experiencing issues:

  1. Check Logs: Review schedule execution logs
  2. Document Issue: Note error messages and steps to reproduce
  3. Test Isolated: Test with minimal configuration
  4. Contact Support: Reach out with detailed information

Prevention Tips​

  • Test Before Scheduling: Always test schedules first
  • Monitor Regularly: Check schedule execution
  • Keep Updated: Update app and theme regularly
  • Document Configurations: Keep records of settings

Resources​