WooCommerce Shipping icon
eCommerce & WooCommerce

WooCommerce Shipping hooks reference

  • By WooCommerce
  • v2.5.1 New
  • Updated

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.

functions.phpyour child theme
// 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

  • src/Banners/BulkLabelsBanner.php line 58 · used in 9 places
    /**
     * 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(), ), ) );
  • src/LabelPurchase/LabelPurchaseService.php line 365 · used in 2 places
    /**
     * Trigger return label email notification.
     */
    do_action( 'wcshipping_return_label_created', $order_id, $label_meta, $attachments );
  • classes/class-wc-connect-nux.php line 473 · used in 2 places
    /**
     * Fires when the user dismisses the setup complete banner.
     */
    do_action( 'wcshipping_setup_complete_banner_dismissed' );
  • src/LabelPurchase/View.php line 308
    /**
     * Filter the account settings payload passed to the shipping-label UI.
     */
    apply_filters( 'wcshipping_account_settings_payload', null, $this->settings_store );
  • src/Integrations/WCST.php line 80
    /**
     * Filter so other sources can prevent the plugin override from happening.
     */
    apply_filters( 'wcshipping_allow_override_plugin_name', true );
  • src/LabelPurchase/View.php line 219
    /**
     * 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() );
  • src/FeatureFlags/FeatureFlags.php line 97
    /**
     * Filter to enable the bulk label printing feature.
     */
    apply_filters( 'wcshipping_enable_bulk_labels_feature', false );
  • src/FeatureFlags/FeatureFlags.php line 77
    /**
     * Filter to enable/disable USPS ScanForm feature.
     */
    apply_filters( 'wcshipping_enable_scanform_feature', $enabled_by_setting );
  • src/LabelPurchase/View.php line 366
    /**
     * Filter the custom fulfillment summary message displayed in the shipping meta
     * box.
     */
    apply_filters( 'wcshipping_fulfillment_summary', '', $order->get_id(), $label_data );
  • src/Integrations/Garden.php line 29
    /**
     * Filter whether Garden config is enabled.
     */
    apply_filters( 'wcshipping_garden_is_config_enabled', function_exists( 'garden_get_wpcloud_config' ) );
  • src/Integrations/Garden.php line 57
    /**
     * Filter the WPCloud config value.
     */
    apply_filters( 'wcshipping_garden_wpcloud_config', $value, $key );
  • classes/class-wc-connect-extension-compatibility.php line 42
    /**
     * Filter the flag indicating whether WooCommerce Shipping should add tracking
     * info to emails.
     */
    apply_filters( 'wcshipping_include_email_tracking_info', true );
  • classes/class-wc-connect-api-client.php line 626
    /**
     * Filter the Jetpack access token used for Connect Server requests.
     */
    apply_filters( 'wcshipping_jetpack_access_token', $token );
  • classes/class-wc-connect-nux.php line 181
    /**
     * Filter the derived Jetpack install/connection status used by NUX checks.
     */
    apply_filters( 'wcshipping_jetpack_install_status', $status );
  • src/Loader.php line 414
    /**
     * Action hook for when the plugin is activated.
     */
    do_action( 'wcshipping_plugin_activation' );
  • src/Loader.php line 391
    /**
     * Action hook for when the plugin is deactivated.
     */
    do_action( 'wcshipping_plugin_deactivation' );
  • classes/class-wc-connect-settings-pages.php line 110
    /**
     * Determine which render callback to use for the settings page
     */
    do_action( 'wcshipping_render_wc_settings_page' );
  • src/Loader.php line 1223
    /**
     * 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', ) );
  • classes/class-wc-connect-service-settings-store.php line 220
    /**
     * Action hook fired after successful settings save.
     */
    do_action( 'wcshipping_settings_saved', array_merge( $validated_settings, array( 'paper_size' => $paper_size ) ) );
  • classes/class-wc-connect-nux.php line 576
    /**
     * Track when a banner is shown.
     */
    do_action( 'wcshipping_show_banner', $content['source'] );
  • classes/class-wc-connect-nux.php line 326
    /**
     * Fires when the user accepts our ToS.
     */
    do_action( 'wcshipping_tos_accepted', $source );
  • classes/class-wc-connect-nux.php line 312
    /**
     * Fires if the user has already accepted our ToS.
     */
    do_action( 'wcshipping_tos_already_accepted', $source );
  • src/Integrations/WooCommerceShipmentTracking.php line 86
    /**
     * 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 );
  • src/Loader.php line 444
    /**
     * Action triggered when the wcshipping plugin is updated.
     */
    do_action( 'wcshipping_updated', $current_version, WCSHIPPING_VERSION );
  • classes/class-wc-connect-nux.php line 403
    /**
     * Fires when we have a successful authorization return.
     */
    do_action( 'wcshipping_wpcom_connect_site_connected', $source );
  • classes/class-wc-connect-jetpack.php line 175
    /**
     * Fire when the site is about to be connected to WP.com.
     */
    do_action( 'wcshipping_wpcom_connect_site_error', $result );
  • classes/class-wc-connect-jetpack.php line 195
    /**
     * Fire when the site is about to be connected to WP.com.
     */
    do_action( 'wcshipping_wpcom_connect_site_start', $source );
  • src/Fulfillments/ShippingFulfillment.php line 569
    /**
     * Trigger the fulfillment created notification.
     */
    do_action( 'woocommerce_fulfillment_created_notification', $order_id, $this, $order );
  • src/Fulfillments/ShippingFulfillment.php line 601
    /**
     * Trigger the fulfillment deleted notification on deleting a fulfilled
     * fulfillment.
     */
    do_action( 'woocommerce_fulfillment_deleted_notification', $order_id, $this, wc_get_order( $order_id ) );
  • src/Fulfillments/ShippingFulfillment.php line 574
    /**
     * Trigger the fulfillment updated notification.
     */
    do_action( 'woocommerce_fulfillment_updated_notification', $order_id, $this, $order );
  • classes/wc-api-dev/class-wc-rest-dev-data-continents-controller.php line 152
    /**
     * Filter the location list returned from the API.
     */
    apply_filters( 'woocommerce_rest_prepare_data_continent', $response, $item, $request );
  • src/Checkout/CheckoutService.php line 214
    /**
     * Filters the checkout address normalization error message.
     */
    apply_filters( 'woocommerce_shipping_address_normalization_response_error_message', $message );
  • templates/emails/admin-return-label.php line 129 · used in 4 places
    do_action( 'woocommerce_email_customer_details', $order, $sent_to_admin, $plain_text, $email );
  • templates/emails/admin-return-label.php line 115 · used in 4 places
    do_action( 'woocommerce_email_order_details', $order, $sent_to_admin, $plain_text, $email );
  • templates/emails/admin-return-label.php line 123 · used in 4 places
    do_action( 'woocommerce_email_order_meta', $order, $sent_to_admin, $plain_text, $email );
  • classes/class-wc-connect-shipping-label.php line 552 · used in 3 places
    apply_filters( 'wcshipping_features_supported_by_store', array() );
  • classes/class-wc-connect-api-client-live.php line 44 · used in 3 places
    apply_filters( 'wcshipping_server_url', $url );
  • classes/class-wc-connect-api-client-live.php line 50 · used in 2 places
    apply_filters( 'wcshipping_api_client_body', $body );
  • classes/legacy-api-controllers/class-wc-rest-connect-shipping-carrier-controller.php line 27 · used in 2 places
    do_action( 'wcshipping_fetch_service_schemas' );
  • classes/class-wc-connect-shipping-label.php line 543 · used in 2 places
    apply_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'],... );
  • classes/class-wc-connect-api-client-live.php line 77 · used in 2 places
    apply_filters( 'wcshipping_request_args', $args );
  • classes/class-wc-connect-functions.php line 143 · used in 2 places
    apply_filters( 'wcshipping_user_can_manage_labels', current_user_can( 'manage_woocommerce' ) || current_user_can( 'wcshipping_manage_labels' ) );
  • templates/emails/admin-return-label.php line 20 · used in 2 places
    do_action( 'woocommerce_email_header', $email_heading, $email );
  • src/Loader.php line 776
    apply_filters( 'wc_services_will_disable_shipping_logic', false );
  • src/Loader.php line 774
    apply_filters( 'wc_services_will_handle_coexistence_with_woo_shipping_and_woo_tax', false );
  • src/Banners/Banners.php line 119
    apply_filters( 'wcshipping_feature_banner_target_screens', $target_screens );
  • src/Migration/LegacyLabelMigrator.php line 310
    do_action( 'wcshipping_labels_migration_completed', array( 'orders_migrated' => $this->total_processed_count ) );
  • src/Migration/LegacyLabelMigrator.php line 342
    do_action( 'wcshipping_labels_migration_started', array( 'orders_to_migrate' => $this->get_total_pending_count() ) );
  • src/LabelPurchase/LabelPrintService.php line 187
    apply_filters( 'wcshipping_packing_list_html', $packing_slip_html, $order_id, $label_id );
  • src/LabelPurchase/LabelPrintService.php line 420
    apply_filters( 'wcshipping_packing_list_without_label_html', $packing_slip_html, $order_id );
  • src/Migration/LegacySettingsMigrator.php line 81
    do_action( 'wcshipping_settings_migration_completed' );
  • src/Migration/LegacySettingsMigrator.php line 77
    do_action( 'wcshipping_settings_migration_started' );
  • classes/legacy-api-controllers/class-wc-rest-connect-services-controller.php line 47
    apply_filters( 'wcshipping_shipping_service_settings', array( 'success' => true, ), $method_id, $instance_id );
  • src/Loader.php line 1748
    do_action( 'wcshipping_shipping_zone_method_added', $instance_id, $service_id, $zone_id );
  • src/Loader.php line 1755
    do_action( 'wcshipping_shipping_zone_method_deleted', $instance_id, $service_id, $zone_id );
  • src/Loader.php line 1761
    do_action( 'wcshipping_shipping_zone_method_status_toggled', $instance_id, $service_id, $zone_id, $enabled );
  • src/Utils.php line 210
    apply_filters( 'wcshipping_should_use_fulfillment_api', (bool) $use_fulfillment_api );
  • src/ScanForm/ScanFormService.php line 501
    apply_filters( 'wcshipping_usps_scanform_min_shipment_date_timestamp', $today_utc->getTimestamp() );
  • src/Emails/WC_Return_Label_Email.php line 283
    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: