Runs when the order status changes (uses the order’s new status in the action hook name).

do_action( 'pmpro_order_status_' . $this->status, $this, $this->original_status );

There are six built-in forms of this hook (more if you have added custom order statuses or are using an Add On that extends). Hook variations include:

  • pmpro_order_status_error
  • pmpro_order_status_pending
  • pmpro_order_status_refunded
  • pmpro_order_status_review
  • pmpro_order_status_success
  • pmpro_order_status_token

Click here to learn about the various order statuses in Paid Memberships Pro.


object; The current member order object
string; The original status before changing to the new status



View in Source Code

About Actions and Filters in PMPro

Hooks allow you to extend Paid Memberships Pro without editing any core plugin files. You can use a hook to program custom code that interacts with or modifies code in our plugin, Add Ons, your theme, and even WordPress itself.

There are two kinds of hooks: actions and filters.

  • Action hooks allow you to run new custom code at pre-defined locations.
  • Filter hooks allow you to change or extend existing code by modifying the data and returning it back to the software.

Click here to browse the full database of action and filter hooks available in Paid Memberships Pro. For help extending our Add Ons, refer to the individual Add On's documentation page for a list of available hooks.

For more developer-focused information about Paid Memberships Pro, check out the advanced developer topics documentation.

Was this article helpful?