wp cron event <command>

Schedules, runs, and deletes WP-Cron events.

In this article

Examples

# Schedule a new cron event
$ wp cron event schedule cron_test
Success: Scheduled event with hook 'cron_test' for 2016-05-31 10:19:16 GMT.

# Run all cron events due right now
$ wp cron event run --due-now
Executed the cron event 'cron_test_1' in 0.01s.
Executed the cron event 'cron_test_2' in 0.006s.
Success: Executed a total of 2 cron events.

# Delete all scheduled cron events for the given hook
$ wp cron event delete cron_test
Success: Deleted a total of 2 cron events.

# List scheduled cron events in JSON
$ wp cron event list --fields=hook,next_run --format=json
[{"hook":"wp_version_check","next_run":"2016-05-31 10:15:13"},{"hook":"wp_update_plugins","next_run":"2016-05-31 10:15:13"},{"hook":"wp_update_themes","next_run":"2016-05-31 10:15:14"}]

Subcommands

NameDescription
wp cron event delete

Deletes all scheduled cron events for the given hook.

wp cron event list

Lists scheduled cron events.

wp cron event run

Runs the next scheduled cron event for the given hook.

wp cron event schedule

Schedules a new cron event.

wp cron event unschedule

Unschedules all cron events for a given hook.

Command documentation is regenerated at every release. To add or update an example, please submit a pull request against the corresponding part of the codebase.