Subscriptions for WooCommerce with Stripe Recurring Payments 2.5.2 has 59 actions and 69 filters, read directly from its source code on Nov 18, 2026. The list updates automatically when a new version is released.
How to use these hooks
Actions let you run your own code at a specific moment. Filters let you change a value before the plugin uses it. Put your code in a child theme's functions.php or a code-snippets plugin, never in the plugin's own files, because updates overwrite them.
// Run your own code when Subscriptions for WooCommerce with Stripe Recurring Payments fires an action
add_action( 'subscrpt_subscription_saved', function( $subscription_id, $data ) {
// Your code runs here.
}, 10, 2 );
// Change a value Subscriptions for WooCommerce with Stripe Recurring Payments is about to use
add_filter( 'subscrpt_coupon_is_recurring', function( $value, $coupon, $cart_item_key ) {
// Change $value here.
return $value;
}, 10, 3 );Parts of a name in {braces} are filled in at runtime (for example a post type or field ID). Choose Example on any hook for a ready-to-edit snippet.
All hooks
-
/** * Filters whether a coupon's discount also applies to subscription renewals. */ apply_filters( 'subscrpt_coupon_is_recurring', false, $coupon, $cart_item_key ); -
/** * Filters how many payments a recurring coupon's discount covers. */ apply_filters( 'subscrpt_coupon_recurring_limit', 0, $coupon, $cart_item_key ); -
/** * Fires when a customer opens the cancellation modal and backs out. */ do_action( 'subscrpt_subscription_saved', $subscription_id, $data ); -
/** * Filters the pro licence state shown in the admin header. */ apply_filters( 'subscrpt_admin_header_license', null ); -
/** * Filters the notices shown on WPSubscription admin screens. */ apply_filters( 'subscrpt_admin_notices', array() ); -
/** * Filters whether the cart may hold more than one subscription, or a * subscription alongside a normal product, bypassing the restriction below. */ apply_filters( 'subscrpt_allow_multiple_subscriptions_in_cart', false, $variation_id > 0 ? $variation_id : $product_id ); -
/** * Filter the built-in default cancellation reasons. */ apply_filters( 'subscrpt_cancellation_default_reasons', $reasons ); -
/** * Fires after a cancellation-feedback row is stored. */ do_action( 'subscrpt_cancellation_feedback_recorded', $subscription_id, $data ); -
/** * Filters the retention offer handed to a cancelling customer. */ apply_filters( 'subscrpt_cancellation_offer', null, $subscription_id, $author_id ); -
/** * Filter the timestamp at which a pending cancellation becomes a full * cancellation. */ apply_filters( 'subscrpt_cancellation_time', $this->default_cancellation_time( $subscription_id ), $subscription_id ); -
/** * Fires after a cart subscription is swapped for another. */ do_action( 'subscrpt_cart_subscription_switched', $added, $pending ); -
/** * Filters the customer actions passed on through `subscrpt_execute_actions`. */ apply_filters( 'subscrpt_customer_actions', array( 'early-renew', 'cancel-downgrade', 'box-skip' ) ); -
/** * Filters the announcement banner at the top of the dashboard. */ apply_filters( 'subscrpt_dashboard_announcement', $announcement ); -
/** * Fires at the bottom of the details main (left) column, after the activities * card. */ do_action( 'subscrpt_details_main_bottom', $subscrpt_details_ctx ); -
/** * Fires at the top of the details main (left) column, before the summary * strip. */ do_action( 'subscrpt_details_main_top', $subscrpt_details_ctx ); -
/** * Fires at the bottom of the details sidebar (right) column, after the * secondary info cards. */ do_action( 'subscrpt_details_side_bottom', $subscrpt_details_ctx ); -
/** * Fires at the top of the details sidebar (right) column, before the action * card. */ do_action( 'subscrpt_details_side_top', $subscrpt_details_ctx ); -
/** * Fires inside the subscription details activities card. */ do_action( 'subscrpt_order_activities', $subscription_id ); -
/** * Filters the discount badge text on a storefront plan selector card. */ apply_filters( 'subscrpt_plan_card_badge', $default, $group, $product, $percent ); -
/** * Fires once per purchase option, in its body. */ do_action( 'subscrpt_plan_card_body', $group, $product, $context ); -
/** * Filter the product-picker results. Free returns simple products only; Pro * hooks this to append variable products (with nested variations). */ apply_filters( 'subscrpt_plan_products', $results, $search ); -
/** * Filters whether free renders the purchase options while Pro is active. */ apply_filters( 'subscrpt_plan_selector_from_free', false ); -
/** * Filters the storefront plan selector groups, One-Time card included. */ apply_filters( 'subscrpt_plan_selector_groups', $groups, $product, $context ); -
/** * Filters the CSS printed after the purchase options' stylesheet. */ apply_filters( 'subscrpt_plan_selector_inline_css', $css ); -
/** * Filters the purchase option layouts a product page can use. */ apply_filters( 'subscrpt_plan_selector_layouts', $defaults ); -
/** * Filters one term of the storefront plan selector after it is built. */ apply_filters( 'subscrpt_plan_term', $term, $row, $type_key, $product ); -
/** * Fires at the end of the product-editor plan view. Pro hooks this to add more * plan-related inputs to the Subscription tab. */ do_action( 'subscrpt_product_plan_view', $product ); -
/** * Fires so add-ons can register options into the Cancellation Flow group. */ do_action( 'subscrpt_register_cancellation_settings', self::OPTION_GROUP ); -
/** * Filter the resolved plan rows for a product. */ apply_filters( 'subscrpt_resolve_plans_for_product', $resolved, $product_id, $variation_id ); -
/** * Filters how long a save report is held back, in seconds. */ apply_filters( 'subscrpt_save_report_delay', 5 * MINUTE_IN_SECONDS, $subscription_id ); -
/** * Fires when a paid subscription order has no reusable Stripe payment method. */ do_action( 'subscrpt_stripe_reusable_pm_missing', (int) $order_id, $intent_id ); -
/** * Filter the language a subscription's customer emails are written in. */ apply_filters( 'subscrpt_subscription_language', array( 'locale' => $locale, 'language' => $language, ), $subscription_id ); -
/** * Filter the subscription next payment date before it is saved. */ apply_filters( 'subscrpt_subscription_next_date', $next_date, $subscription_id, $recurr_timing, $subscription_history->type ); -
/** * Fires after a subscription is paused because of low stock. */ do_action( 'subscrpt_subscription_stock_paused', $subscription_id, $product ); -
/** * Fires after a subscription is resumed because stock recovered. */ do_action( 'subscrpt_subscription_stock_resumed', $subscription_id, $product ); -
/** * Action fired when subscription switch order is created. */ do_action( 'subscrpt_switch_order_created', $switch_type, $order, $order_item, $switch_context ); -
/** * Fires inside the Subscription tab for a variable product. Pro hooks this to * render its per-variation subscription sections. */ do_action( 'subscrpt_variable_subscription_panel', $subscrpt_current ); -
/** * Filter the return value of the * WC_Payment_Gateway_CC::generate_create_intent_request. */ apply_filters( 'wc_stripe_generate_create_intent_request', $request, $order, $prepared_source ); -
/** * Filter the paginator info text (right-hand label, e.g. "Showing 1–10 of * 96"). */ apply_filters( 'wpsubs_pager_info_text', $info_text, $start_item, $end_item, $item_total, $args['context'] ); -
/** * Filter the label rendered for a paginator page button. */ apply_filters( 'wpsubs_pager_page_label', $label, $p, $is_active ); -
do_action( 'woocommerce_email_header', $email_heading, $email ); -
apply_filters( 'subscrpt_split_payment_button_text', $label, 'cancel', $id, $status ); -
apply_filters( 'wpml_current_language', null ); -
apply_filters( 'subscrpt_format_price_with_subscription', $formatted_price, $price, $subscription_id ); -
do_action( 'subscrpt_order_checkout', $selected_subscription_id, $order_item ); -
apply_filters( 'subscrpt_payment_order_types', array( 'new', 'renew', 'early-renew' ) ); -
apply_filters( 'wpml_active_languages', null, array( 'skip_missing' => 0 ) ); -
apply_filters( 'wpml_default_language', null ); -
do_action( 'wpml_register_single_string', self::STRING_CONTEXT, self::group_string_name( $group_id ), $title ); -
do_action( 'wpml_switch_language', $target['language'] ); -
apply_filters( '_subscrpt_product_data_class', SubscriptionProduct::class, $product ); -
do_action( 'after_subscription_update_cron' ); -
do_action( 'before_single_subscrpt_content', $id ); -
do_action( 'before_subscription_update_cron' ); -
apply_filters( 'process_subscrpt_settings_fields', $settings_fields ); -
apply_filters( 'subscript_order_status_to_post_status', $post_status, $order ); -
apply_filters( 'subscrpt_active_role_grant_allowed', $allowed, $subscription_id, $role ); -
apply_filters( 'subscrpt_admin_info_rows', $rows, $subscription_id, $order ); -
do_action( 'subscrpt_after_create_renew_order', $new_order, $old_order, $subscription_id, false ); -
do_action( 'subscrpt_after_subscription_totals', (int) $id ); -
apply_filters( 'subscrpt_before_saving_renewal_order', $new_order, $old_order, $subscription_id ); -
do_action( 'subscrpt_before_subscription_totals', (int) $id ); -
apply_filters( 'subscrpt_block_simple_cart_item_data', $subscription_data, $product, $cart_item_data ); -
apply_filters( 'subscrpt_cart_recurring_data', array( 'price' => $price_data['total'], 'full_price' => $price_data['full_total'], 'first_price' => $price_data['first_total'], 'has_recurring_discount' => $price_data['has_recurring_discount'], 'has_one_time_discount' => $price_data['has_one_time_discount'], 'recurring_limit' => $price_data['recurring_limit'], 'time' => $time, 'type' => $type, 'description' => $description, 'can_user_cancel' =... ); -
apply_filters( 'subscrpt_cart_switch_notice', $notice, $pending ); -
apply_filters( 'subscrpt_completion_timeout_days', 0, $subscription_id ); -
do_action( 'subscrpt_execute_actions', $subscrpt_id, $action ); -
apply_filters( 'subscrpt_expired_email_delay', HOUR_IN_SECONDS ); -
apply_filters( 'subscrpt_force_completion_on_suspension', false, $subscription_id ); -
do_action( 'subscrpt_grace_period_ended', $subscription_id ); -
do_action( 'subscrpt_grace_period_started', $subscription_id ); -
apply_filters( 'subscrpt_max_failures_before_completion', 0, $subscription_id ); -
apply_filters( 'subscrpt_order_item_post_args', $args ); -
apply_filters( 'subscrpt_order_post_args', $args ); -
apply_filters( 'subscrpt_order_relational_types', array( 'new' => __( 'New Subscription Order', 'subscription' ), 'renew' => __( 'Renewal Order', 'subscription' ), ) ); -
do_action( 'subscrpt_order_status_changed', $order, $history ); -
do_action( 'subscrpt_product_checkout', $order_item, $product, $post_status ); -
do_action( 'subscrpt_register_settings', 'subscrpt_settings' ); -
do_action( 'subscrpt_render_boxes_page' ); -
do_action( 'subscrpt_render_delivery_page' ); -
do_action( 'subscrpt_render_health_page' ); -
do_action( 'subscrpt_render_stats_page' ); -
apply_filters( 'subscrpt_renewal_actions', array( 'renew', 'renew-on', 'early-renew' ) ); -
apply_filters( 'subscrpt_renewal_item_meta', wc_get_order_item_meta( $order_item->get_id(), '_subscrpt_meta', true ), $product, $order_item ); -
apply_filters( 'subscrpt_renewal_product_args', $product_args, $product, $order_item ); -
apply_filters( 'subscrpt_role_management_managed_roles', array_unique( [ 'customer', 'subscriber', self::get_default_active_role(), self::get_default_inactive_role() ] ), $user ); -
apply_filters( 'subscrpt_settings_fields', $settings_fields ); -
apply_filters( 'subscrpt_simple_price_html', $price_html, $product, $price, $trial ); -
do_action( 'subscrpt_simple_pro_fields', get_the_ID() ); -
apply_filters( 'subscrpt_single_action_buttons', $action_buttons, $id, $subscrpt_nonce, $status ); -
apply_filters( 'subscrpt_split_payment_args', $split_payment_args, $order_item, $product ); -
do_action( 'subscrpt_split_payment_cancelled', $subscription_id ); -
do_action( 'subscrpt_split_payment_completed', $subscription_id, $payments_made, $max_payments ); -
do_action( 'subscrpt_split_payment_created', $subscription_id, $split_payment_args, $order_item ); -
apply_filters( 'subscrpt_split_payment_disable_cancel', false, $id, $status ); -
apply_filters( 'subscrpt_split_payment_expire_status', 'completed', $subscription_id, $payments_made, $max_payments ); -
apply_filters_deprecated( 'subscrpt_split_payment_next_due_date', [ $next_date, $subscription_id, $recurr_timing, $type ], '1.11.0', 'subscrpt_subscription_next_date' ); -
do_action( 'subscrpt_split_payment_renewed', $subscription_id, $order_id, $order_item_id ); -
apply_filters( 'subscrpt_split_payment_total_override', $max_payments, $subscription_id, $product_id ); -
do_action( 'subscrpt_status_changed_admin_email_notification', $post_id, $old_status_object->label, $new_status_object->label ); -
do_action( 'subscrpt_subscription_activated', $subscription_id ); -
do_action( 'subscrpt_subscription_cancelled', $subscription_id ); -
do_action( 'subscrpt_subscription_cancelled_email_notification', $subscription_id ); -
do_action( 'subscrpt_subscription_completed', $subscription_id ); -
do_action( 'subscrpt_subscription_expired', $subscription_id ); -
do_action( 'subscrpt_subscription_expired_email_notification', $subscription_id ); -
do_action( 'subscrpt_subscription_on_hold', $subscription_id ); -
do_action( 'subscrpt_subscription_payment_completed', $subscription_id, $payment_id ); -
do_action( 'subscrpt_subscription_payment_failed', $subscription_id ); -
do_action( 'subscrpt_subscription_pending', $subscription_id ); -
do_action( 'subscrpt_subscription_pending_cancellation', $subscription_id ); -
do_action( 'subscrpt_subscription_resumed', $subscription_id, $old_status ); -
do_action( 'subscrpt_subscription_status_changed', $subscription_id, $old_status, $status ); -
do_action( 'subscrpt_subscription_stock_paused_email_notification', $subscription_id ); -
do_action( 'subscrpt_when_product_expired', $subscription_id, true ); -
do_action( 'wc_gateway_stripe_process_payment_error', $e, $renewal_order ); -
apply_filters( 'wc_stripe_force_save_payment_method', false, $order->get_id() ); -
apply_filters( 'wp_subs_paypal_supported_currencies', [ 'AUD', 'BRL', 'CAD', 'MXN', 'NZD', 'HKD', 'SGD', 'USD', 'EUR', 'JPY', 'NOK', 'CZK', 'DKK', 'HUF', 'ILS', 'MYR', 'PHP', 'PLN', 'SEK', 'CHF', 'TWD', 'THB', 'GBP', 'RUB', 'INR' ] ); -
apply_filters( 'wp_subscription_paypal_icon', SUBSCRPT_URL . '/assets/images/integrations/paypal.svg' ); -
apply_filters( 'wpml_object_id', $post_id, $post_type, false, $language ); -
apply_filters( 'wpml_translate_single_string', $value, self::STRING_CONTEXT, $name ); -
apply_filters( 'wpsubs_cart_recurring_items', $recurrs, $cart_items ); -
apply_filters( 'wpsubs_integrations', $integrations ); -
apply_filters( 'wpsubs_pager_link_url', $url, $page, $args );
Generated from Subscriptions for WooCommerce with Stripe Recurring Payments's GPL-licensed source code. Hooks inside bundled third-party libraries are not listed.
Done for you
Rather have it built for you?
Tell us what should change and we’ll write and test the code using these hooks.
Custom hook snippet
from $49
A small, update-safe change built on the plugin’s own hooks.
- Code written against the plugin’s actions and filters
- Tested on a staging copy of your site
- Install instructions included
Typical turnaround: 2–3 business days
Choose thisPlugin customisation
from $149
New features or changed behaviour, without editing the plugin’s files.
- Built as a companion plugin, so updates never wipe it
- Exact quote before we start
- Tested on staging, then deployed
Typical turnaround: 3–7 business days
Choose thisNot sure which fits? Describe what you need and we’ll suggest the simplest option.
Can't find the right hook?
We can build the customisation for you. Describe what you need: