Insights into WP-Cron: An Introduction to Scheduling Tasks in WordPress


Today we'll be looking at the WP-Cron functions, one of the lesser known tricks that you can use for some fun! The primary purpose is for setting up scheduling or other time-sensitive tasks. We'll examine some tricks for using it, and we'll also identify some potential problems with it and how to work around them.

WordPress is a powerful piece of software. Its simplicity can often give the wrong impression to non-technical users about its inner workings though. This might have served in the best interest of WordPress, as something that feels simple and easier to use is generally adopted by the masses. However, it's important to remember that behind the scenes is a powerful piece of software that's capable of doing quite a bit more than simple blogging.

One of the features in WordPress that is written less about has to be WP-Cron (check out the codex page on WP-Cron here). Now those of you who have dealt with general Cron on a Linux server know the power of this function.

What is Cron?

Cron is a UNIX command for scheduling jobs to be executed sometime in the future. A cron is normally used to schedule a job that is executed periodically. For example, you might use a cron function to send out a notice every morning. It is also a daemon process, meaning that it runs continuously, waiting for specific events to occur.

The Way It Works

As WordPress is installed on so many different setups, to make things run properly, WordPress developers implemented a pseudo cron that includes the WP-Cron functions that helps run scheduling jobs such as:

  • Checking for theme & plugin updates
  • Publish scheduled posts
  • Sending pingbacks
  • and more!

Unlike regular cron jobs, which run at specific time based on the server settings, the WP-Cron function runs every time someone visits the WordPress powered website. This makes a WordPress site run properly on different kinds of server setups because it eliminates a lot of server-specific requirements. On every page load, WordPress checks if there is a need for WP-Cron to run. If there is a need, then it tries to make a request over HTTP to the wp-cron.php file.

The reason to call wp-cron.php is because some jobs might take more time and the user requesting the WordPress page cannot be made to wait. Calling the wp-cron.php helps keep the WP-Cron function running as a separate process in the background without delaying the page load time for the user. Once the WP-Cron function starts, it continues to run until all the required jobs are completed or until it reaches an execution time as set in the server configuration.

Based on the setup of your web host, WP-Cron can fail to complete its jobs or it might not work at all. High traffic websites face another set of issues like multiple WP-Cron processes running in loops. Mostly people blame WordPress for it, but it’s not necessarily an issue with WordPress. Every situation is different and based on it we can tweak WordPress to run in the best possible way. Below, you would find some of the common issues people face and how to fix them.

Some Issues with WP-Cron

Issue: Multiple running WP-Cron process on high traffic websites

If you are a server administrator or manage your own server with a firewall, you might have received emails from your firewall about a file "wp-cron.php" running for a long period of time. This happens when the script execution time set on your server is more than 60 seconds. As the process is not terminated, and since new processes are started, multiple instances of the WP-Cron process run on the server.

This does not happen on a low traffic website, but if your WordPress powered website has simultaneous users at any given moment and the maximum script execution time is set high, then there will be many instances of this WP-Cron function running. Until a recent version of WordPress, there was always an issue of multiple cron processes looping over the same events.

NOTE: WordPress 3.3 gives us even better cron locking. This article was written just as WordPress 3.3 was being released, which features better cron locking and avoiding multiple WP-Cron processes looping over the same events.

Issue: Scheduled posts missed

Another widely reported issue with some hosting providers & some very low traffic websites is scheduled posts not getting published. As the WP-Cron function only runs when there is a page request, if there are no requests then the scheduled jobs are not run.

Note: There is not a problem with WordPress. Also since version 3.x this has been reported much less. However there are many plugins to take care of this issue.

Issue: WP-Cron does not run at all

Again this is a problem with the server setup. Due to improper settings, firewall blocks that stop scripts from calling themselves so the WP-Cron function does not work.

Possible Solution to Most WP-Cron Problems

To avoid multiple instances of WP-Cron running on your server for a single website, I have tried to use the default way of setting up cron jobs on a Linux server (Apache with cPanel as the control panel). The benefit of this method is:

  • More control on when the WP-Cron function runs.
  • Avoid multiple loops.
  • If you own a server with lot of WordPress websites hosted, then this can reduce the server load.

Before you get into this, make sure that your web host allows you to setup default Linux cron jobs. The way this is setup would be different based on the control panel offered by your host, but in this article I will provide a guide to setup a cron job using the cPanel control panel that is common on Linux servers nowadays.

The steps I followed were:

  1. Disable internal WP-Cron to execute on page load.
  2. Setup a cron function that makes a get request to the wp-cron.php file at regular intervals based on your preference.

Yes, it’s that simple. Just two steps to make things run smoother.

NOTE: Before you follow this method, please note that disabling internal WP-Cron can also result in the website not running properly based on your setup or the plugins used.

1. Disable internal WP-Cron function

Open the wp-config.php file in NotePad or the editor of your choice and add the below two lines at the top.

//Disable internal Wp-Cron function
define('DISABLE_WP_CRON', true);

This will now stop the internal WP-Cron function from executing and will not call the wp-cron.php file.

2. Setup a real cron function from your host's control panel

If you are allowed to setup cron jobs, you would have to setup a cron as below:

wget > /dev/null 2>&1

Below are the steps to do this from a cPanel based host.

1. Access your account's cPanel

Usually the link is or Once your enter your user id and password and enter the control panel, scroll down to the "Advanced section".

2. Go to Cron Settings Page

Click on the "Cron Jobs" icon in the advanced section.

WordPress Login Page

3. Setup a Cron Job

WordPress Login Page

On the new page you would find an "Add New Cron Job" section like the one in the above image. From the Common Settings drop down field, select "Every 5 minutes...". Once you select this, the rest of the fields will be automatically filled with the necessary information. In the next step I will explain my intention of setting up a 5 minute interval to run the script.

In the command field, add the below line. Remember to add the correct website address.

wget > /dev/null 2>&1

Finally, click on the "Add New Cron Job" button.

From now on the server will make a request for the wp-cron.php file every 5 minutes. Now the reason I have set this as 5 minutes, is because I mostly set the script execution time to 4 minutes instead of 60 seconds. This is done to be able to load large image files, backup processes, etc. However you may also change the settings and choose other options to run the cron every 1 minute.

NOTE: This runs well for general WordPress websites. For those using a WordPress network, there might be additional things required so please do not use the above steps if you run WordPress Multi-site version.


If you face any issues or have other ideas please feel free to share your comments below!

Related Posts
  • Code
    Web Development
    How to Use New Relic With PHP & WordPressRelic retina preview
    Today we will look at how to monitor a PHP application using New Relic. More specifically we will set up a basic WordPress installation and get some performance data about it, in the New Relic dashboards.Read More…
  • Code
    An Introduction To Deploying WordPress with MinaImage400
    As a PHP application, WordPress is usually deployed by a very old method: uploading files via FTP. We have some deployment tools, but they often requires some type of Ruby skill. For example, one popular, powerful tool is Capistrano, but it's also very heavy with many Ruby/Rails related features. I also think that it's little bit tricky to install Capistrano for a PHP developer without any Ruby knowledge. So what options do we have as WordPress developers? In this tutorial, I will introduce you Mina: A small, light tool aims to fast deployment and server automation.Read More…
  • Code
    Coding With KodingCoding with koding retina preview
    Cloud IDEs have been around for a little while now, and they have been pretty good for things like pair programming, or cases where you want to code consistently no matter where you are. Koding just came out of private beta, and they would like to take this notion a couple steps further, with their "cloud ecosystem". In this article we will take a look at what Koding is, as-well as some of the benefits you can get from using it.Read More…
  • Code
    Theme Development
    Moving Away From TimThumb to BFIThumbBfithumb 400
    TimThumb has been a long time favorite image resize script for WordPress theme authors. But, with the new WordPress Theme Submission Requirements on ThemeForest, we have to say goodbye to TimThumb. This article will teach you how to transition your themes away from TimThumb, and into a new image resize script called BFIThumb.Read More…
  • Computer Skills
    Installing OpenWRT on a Raspberry Pi as a New Home FirewallRapi400
    OpenWRT is an active and vibrant home firewall project that was born on the Linksys WRT54G line of home routers. It has grown and expanded to support an amazing array of old and new hardware alike. The list of compatible hardware is large enough to require its own index. With the recent interest in the Raspberry Pi there is of course is an OpenWRT build for it as well. In this tutorial I will show you how to install OpenWRT on a Raspberry Pi, add a second network interface, and replace your home firewall with your new OpenWRT firewall.Read More…
  • Code
    Displaying Information of a Plugin on Your WebsiteWordpressdotorg plugin api border 400
    In the first part of this article, we discussed how to use built-in functions to communicate with and retrieve plugin details. In this tutorial we will put the theory in action to create a simple plugin which will allow us to display details of any plugin hosted on on our WordPress website using shortcodes.Read More…