WooCommerce Shipping 2.5.1 has 30 actions and 31 filters, read directly from its source code on Nov 17, 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 WooCommerce Shipping fires an action
add_action( 'wcshipping_enqueue_script', function( $arg1, $arg2 ) {
// Your code runs here.
}, 10, 2 );
// Change a value WooCommerce Shipping is about to use
add_filter( 'wcshipping_account_settings_payload', function( $value, $settings_store ) {
// Change $value here.
return $value;
}, 10, 2 );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
-
wcshipping_enqueue_script
action/** * Fires when a WCShipping entry-point script should be enqueued. */ do_action( 'wcshipping_enqueue_script', 'woocommerce-shipping-bulk-labels-banner', array( 'bulk_labels_max_orders' => OrdersShippingContextRESTController::BATCH_SIZE_CAP, 'accountSettings' => array( 'purchaseSettings' => $this->settings_store->get_account_settings(), ), ) ); -
/** * Trigger return label email notification. */ do_action( 'wcshipping_return_label_created', $order_id, $label_meta, $attachments ); -
/** * Fires when the user dismisses the setup complete banner. */ do_action( 'wcshipping_setup_complete_banner_dismissed' ); -
/** * Filter the account settings payload passed to the shipping-label UI. */ apply_filters( 'wcshipping_account_settings_payload', null, $this->settings_store ); -
/** * Filter so other sources can prevent the plugin override from happening. */ apply_filters( 'wcshipping_allow_override_plugin_name', true ); -
/** * Filter the connected WPCOM owner data used by the shipping-label metabox. */ apply_filters( 'wcshipping_connection_owner_wpcom_data', WC_Connect_Jetpack::get_connection_owner_wpcom_data() ); -
/** * Filter to enable the bulk label printing feature. */ apply_filters( 'wcshipping_enable_bulk_labels_feature', false ); -
/** * Filter to enable/disable USPS ScanForm feature. */ apply_filters( 'wcshipping_enable_scanform_feature', $enabled_by_setting ); -
/** * Filter the custom fulfillment summary message displayed in the shipping meta * box. */ apply_filters( 'wcshipping_fulfillment_summary', '', $order->get_id(), $label_data ); -
/** * Filter whether Garden config is enabled. */ apply_filters( 'wcshipping_garden_is_config_enabled', function_exists( 'garden_get_wpcloud_config' ) ); -
/** * Filter the WPCloud config value. */ apply_filters( 'wcshipping_garden_wpcloud_config', $value, $key ); -
/** * Filter the flag indicating whether WooCommerce Shipping should add tracking * info to emails. */ apply_filters( 'wcshipping_include_email_tracking_info', true ); -
/** * Filter the Jetpack access token used for Connect Server requests. */ apply_filters( 'wcshipping_jetpack_access_token', $token ); -
/** * Filter the derived Jetpack install/connection status used by NUX checks. */ apply_filters( 'wcshipping_jetpack_install_status', $status ); -
wcshipping_plugin_activation
action/** * Action hook for when the plugin is activated. */ do_action( 'wcshipping_plugin_activation' ); -
/** * Action hook for when the plugin is deactivated. */ do_action( 'wcshipping_plugin_deactivation' ); -
/** * Determine which render callback to use for the settings page */ do_action( 'wcshipping_render_wc_settings_page' ); -
/** * Queue a cron job to refetch the schema data from the WooCommerce Connect * Server. */ apply_filters( 'wcshipping_schema_dependent_options', array( 'woocommerce_store_postcode', 'woocommerce_currency', 'woocommerce_weight_unit', 'woocommerce_dimension_unit', ) ); -
wcshipping_settings_saved
action/** * Action hook fired after successful settings save. */ do_action( 'wcshipping_settings_saved', array_merge( $validated_settings, array( 'paper_size' => $paper_size ) ) ); -
wcshipping_show_banner
action/** * Track when a banner is shown. */ do_action( 'wcshipping_show_banner', $content['source'] ); -
wcshipping_tos_accepted
action/** * Fires when the user accepts our ToS. */ do_action( 'wcshipping_tos_accepted', $source ); -
/** * Fires if the user has already accepted our ToS. */ do_action( 'wcshipping_tos_already_accepted', $source ); -
/** * Filter the tracking items before adding it into order meta. We will use the * same filter used in WC Shipment Tracking to keep integrations working. */ apply_filters( 'wcshipping_tracking_before_add_tracking_items', $tracking_items, $tracking_item, $order_id ); -
wcshipping_updated
action/** * Action triggered when the wcshipping plugin is updated. */ do_action( 'wcshipping_updated', $current_version, WCSHIPPING_VERSION ); -
/** * Fires when we have a successful authorization return. */ do_action( 'wcshipping_wpcom_connect_site_connected', $source ); -
/** * Fire when the site is about to be connected to WP.com. */ do_action( 'wcshipping_wpcom_connect_site_error', $result ); -
/** * Fire when the site is about to be connected to WP.com. */ do_action( 'wcshipping_wpcom_connect_site_start', $source ); -
/** * Trigger the fulfillment created notification. */ do_action( 'woocommerce_fulfillment_created_notification', $order_id, $this, $order ); -
/** * Trigger the fulfillment deleted notification on deleting a fulfilled * fulfillment. */ do_action( 'woocommerce_fulfillment_deleted_notification', $order_id, $this, wc_get_order( $order_id ) ); -
/** * Trigger the fulfillment updated notification. */ do_action( 'woocommerce_fulfillment_updated_notification', $order_id, $this, $order ); -
/** * Filter the location list returned from the API. */ apply_filters( 'woocommerce_rest_prepare_data_continent', $response, $item, $request ); -
/** * Filters the checkout address normalization error message. */ apply_filters( 'woocommerce_shipping_address_normalization_response_error_message', $message ); -
do_action( 'woocommerce_email_customer_details', $order, $sent_to_admin, $plain_text, $email ); -
do_action( 'woocommerce_email_order_details', $order, $sent_to_admin, $plain_text, $email ); -
woocommerce_email_order_meta
actiondo_action( 'woocommerce_email_order_meta', $order, $sent_to_admin, $plain_text, $email ); -
apply_filters( 'wcshipping_features_supported_by_store', array() ); -
wcshipping_server_url
filterapply_filters( 'wcshipping_server_url', $url ); -
wcshipping_api_client_body
filterapply_filters( 'wcshipping_api_client_body', $body ); -
do_action( 'wcshipping_fetch_service_schemas' ); -
wcshipping_meta_box_payload
filterapply_filters( 'wcshipping_meta_box_payload', array( 'order' => $connect_order_presenter->get_order_for_api( $order ), 'accountSettings' => $this->account_settings->get(), 'packagesSettings' => $this->package_settings->get( apply_filters( 'wcshipping_features_supported_by_store', array() ) ), 'shippingLabelData' => $this->get_label_payload( $order->get_id() ), 'continents' => $this->continents->get(), 'context' => $args['args']['context'],... ); -
wcshipping_request_args
filterapply_filters( 'wcshipping_request_args', $args ); -
apply_filters( 'wcshipping_user_can_manage_labels', current_user_can( 'manage_woocommerce' ) || current_user_can( 'wcshipping_manage_labels' ) ); -
woocommerce_email_header
actiondo_action( 'woocommerce_email_header', $email_heading, $email ); -
apply_filters( 'wc_services_will_disable_shipping_logic', false ); -
apply_filters( 'wc_services_will_handle_coexistence_with_woo_shipping_and_woo_tax', false ); -
apply_filters( 'wcshipping_feature_banner_target_screens', $target_screens ); -
do_action( 'wcshipping_labels_migration_completed', array( 'orders_migrated' => $this->total_processed_count ) ); -
do_action( 'wcshipping_labels_migration_started', array( 'orders_to_migrate' => $this->get_total_pending_count() ) ); -
wcshipping_packing_list_html
filterapply_filters( 'wcshipping_packing_list_html', $packing_slip_html, $order_id, $label_id ); -
apply_filters( 'wcshipping_packing_list_without_label_html', $packing_slip_html, $order_id ); -
do_action( 'wcshipping_settings_migration_completed' ); -
do_action( 'wcshipping_settings_migration_started' ); -
apply_filters( 'wcshipping_shipping_service_settings', array( 'success' => true, ), $method_id, $instance_id ); -
do_action( 'wcshipping_shipping_zone_method_added', $instance_id, $service_id, $zone_id ); -
do_action( 'wcshipping_shipping_zone_method_deleted', $instance_id, $service_id, $zone_id ); -
do_action( 'wcshipping_shipping_zone_method_status_toggled', $instance_id, $service_id, $zone_id, $enabled ); -
apply_filters( 'wcshipping_should_use_fulfillment_api', (bool) $use_fulfillment_api ); -
apply_filters( 'wcshipping_usps_scanform_min_shipment_date_timestamp', $today_utc->getTimestamp() ); -
apply_filters( 'woocommerce_email_attachments', $this->attachments, $this->id, $this->object, $this );
Generated from WooCommerce Shipping's GPL-licensed source code. Hooks inside bundled third-party libraries are not listed.
Can't find the right hook?
We can build the customisation for you. Describe what you need: