Magento cron is responsible for running many automated tasks in the background. If it stops working or is configured incorrectly, features like emails, indexing, catalog rules, and scheduled imports may stop functioning properly.
This guide answers common questions about Magento cron, including how it works, how to configure it, and how to troubleshoot common issues.
1. What is Magento cron and why is it important?
Magento cron is a scheduler that runs important background tasks automatically. These tasks include reindexing, sending emails, generating feeds, updating price rules, and cleaning temporary data.
Without cron running properly, many store operations will not execute on time, which can affect store performance and functionality.
2. How do I check if Magento cron is running?
You can verify cron status using several methods:
- Check server cron entries using SSH
- Review the cron_schedule database table
- Check Magento log files
To view cron jobs configured on the server:
crontab -l
3. How do I set up Magento cron?
Magento provides a command to automatically create the required cron entries.
To configure cron correctly:
- Log in to your server using SSH
- Switch to the Magento file system owner
- Navigate to your Magento installation directory
Run the following command:
bin/magento cron:install
This command adds Magento cron jobs to the system crontab between
#~ MAGENTO START and #~ MAGENTO END markers.
After installation, verify the entries using:
crontab -l
Magento relies on properly configured cron jobs to run indexing, emails, and other scheduled tasks.
4. Why are my Magento cron jobs showing as missed?
A cron job may be marked as missed when it does not run within the expected time window.
Common causes include:
- Cron not running every minute
- High server load
- Incorrect cron configuration
- Timeout settings that are too strict
Verify your server cron configuration and Magento scheduling settings to resolve this issue.
5. How can I run Magento cron manually?
You can run Magento cron manually from the Magento root directory using the command below:
bin/magento cron:run
For testing purposes, run the command twice. The first execution schedules jobs, and the second execution processes them.
You can also run a specific cron group if needed:
bin/magento cron:run --group=index
6. What happens if Magento cron is not running?
If cron is not working, several features may stop functioning:
- Emails may not be sent
- Indexers may remain invalid
- Catalog rules may not update
- Scheduled imports or feeds may fail
Regularly monitoring cron helps prevent these issues.
7. Where can I find Magento cron logs?
Magento stores cron logs in the following location:
var/log/cron.log
Additional information may appear in:
- exception.log – critical errors
- debug.log – missed jobs (developer mode)
- support_report.log – failed or missed jobs
Magento also records cron activity in the cron_schedule database table, which includes job status, execution time, and history.
8. How often should Magento cron run?
Magento cron should typically run every minute.
Frequent execution ensures scheduled tasks such as indexing, email processing, and data updates run on time.
If cron runs less frequently, jobs may be delayed or marked as missed.
9. Can I create custom cron jobs in Magento?
Yes, custom cron jobs can be created inside Magento modules.
Developers define cron schedules in the crontab.xml file and link them
to a PHP class that executes the required logic.
Custom cron jobs are commonly used for data synchronization, cleanup tasks, and automation.
10. How can I troubleshoot Magento cron issues?
If Magento cron is not working correctly, follow these steps:
- Verify cron is installed using
bin/magento cron:install - Check crontab entries using
crontab -l - Run cron manually to test execution
- Review cron logs in
var/log/cron.log - Check the
cron_scheduletable for job status - Confirm correct PHP configuration and file permissions
These checks usually identify most cron configuration or execution issues.
Quick Troubleshooting Guide
If Magento cron is not working as expected, use the table below to quickly identify possible causes and solutions.
| Issue | Possible Cause | Recommended Fix |
|---|---|---|
| Cron jobs not running | System cron not configured | Check crontab entries using crontab -l |
| Cron jobs showing as missed | Cron frequency too low or server delay | Ensure cron runs every minute |
| Emails not sending | Email queue not processing | Run cron manually and check logs |
| Indexers remain invalid | Indexer cron not executed | Verify cron schedule and permissions |
| No entries in cron_schedule table | Cron not executing | Run php bin/magento cron:run manually |
Still Need Help?
If you have checked the steps above and cron is still not working correctly, our support team can help diagnose the issue.
You can contact us by email at [email protected] or submit a request using our contact form.
When contacting support, please include:
- Magento version
- Hosting environment details
- Recent error messages or logs
- Steps already attempted