USPS Simple Shipping for Woocommerce


USPS Simple integrates the US postal domestic service as a new shipping method in WooCommerce. The plugin retrieves real-time rates through the USPS API.

By default, the plugin individually calculates the shipping price for each item in the cart, simulating separate shipments. The total price displayed to the customer is the sum of the individual item prices.

For regular-sized items, there is an option to group them based on their weight. If this feature is enabled, the dimensions of the grouped items are disregarded in the calculation.

To ensure compatibility, please set the WooCommerce currency to the US dollar and ensure that the base country is the USA.

USPS Simple supports the following services:

  • Priority Mail Express
  • Priority Mail Express, Hold for Pickup
  • Priority Mail Express, Sunday/Holiday
  • Priority Mail
  • Priority Mail, Hold For Pickup
  • Priority Mail Keys and IDs
  • Priority Mail Regional Rate Box A
  • Priority Mail Regional Rate Box A, Hold For Pickup
  • Priority Mail Regional Rate Box B
  • Priority Mail Regional Rate Box B, Hold For Pickup
  • First-Class Mail Postcards
  • First-Class Mail Stamped Postcards
  • First-Class Mail Large Postcards
  • First-Class Mail Letter
  • First-Class Mail Metered Letter
  • First-Class Mail Large Envelope
  • USPS Ground Advantage
  • USPS Retail Ground
  • Media Mail Parcel
  • Library Mail Parcel


  • Configuration
  • Cart


  1. Upload the plugin folder to the ‘/wp-content/plugins/’ directory.
  2. Activate the plugin through the ‘Plugins’ menu in WordPress.
  3. Now you need configure the plugin: Enter your postcode and check option «Enable this shipping method». You can use the default User ID or enter yours.


4 de septiembre de 2023 1 reply
Functional and quick alternative to people who don’t want to pay very inflated subscription prices for the official WooCommerce USPS shipping plugin. Enable the «commercial» rates setting for the in-store rates. Bravo Dan!
8 de mayo de 2022 2 replies
The price my customers were charged by the plugin is not the same price that is charged went I take the item to the United States postal service office which has caused me to lose money. The most recent item purchased by a customer at my store, the plugin added $47.65 for shipping but then went I actually brought the item to the nearest USPS, I was charged $112.00 for shipping (and my measurements and weight input using Woocommerce were accurate). That was very upsetting!
7 de mayo de 2022
When I enable the USPS Simple shipping method from woocommerce shipping settings the site stopped working. Please suggest.
19 de febrero de 2022
It’s nice when things are simple, but can be frustrating when too simple. This plugin is great for stores that sell products that all ship in the same basic class, ie, priority, first class, and there isn’t a mix of restricted class items like media or library rate items. There is no way to select a single or range of shipping method/rate per class. For example, media mail is a restricted class limited to only certain items, like books or DVDs, but if you also sell cameras or t-shirts, you can’t restrict those products from being offered media mail as a shipping option – and a customer will choose that rate because it’s the lowest, and it will be an invalid shipping method for that product. The only option for media mail items, if you have mixed products in your store, is to disable media mail as a shipping option altogether. This is a disservice to customers and to store owners who would prefer this method for qualified products. I don’t know how difficult it would be to add that capability. This is a very easy plugin to set up and for stores with simple inventory and only shipping in the U.S. I think it would work wonders. But, if you have a store with a mix of product types, this one may not work for you.
Leer todas las 27 reseñas

Colaboradores y desarrolladores

«USPS Simple Shipping for Woocommerce» es un software de código abierto. Las siguientes personas han colaborado con este plugin.


Registro de cambios


  • Tested with WooCommerce 8.9, 9.0.


  • Tested with WordPress 6.5, WooCommerce 8.8.


  • Tested with WooCommerce 8.7.


  • Tested with WooCommerce 8.4.


  • Skip calculations if no zip code provided.
  • Fix debug mode error on missing product dimensions.


  • Tested with WordPress 6.4, WooCommerce 8.3.
  • Raise the min required WooCommerce version to 5.0.


  • Tested with WooCommerce 8.1.


  • Tested with WordPress 6.3, WooCommerce 8.0.


  • Fixed the default titles of the First-Class Mail Postcard services.
  • Tested with WooCommerce 7.9.


  • Replace First-Class Mail Parcel and Package with the new USPS Ground Advantage service (enabled by default).
  • Tested with WooCommerce 7.8.


  • Declare HPOS compatibility.
  • Tested with WordPress 6.2, WooCommerce 7.7.


  • Media Mail & Library Mail: always show the lowest of the rates to work around the USPS API inconsistency.


  • Enable the plugin for Guam.


  • Fix the Media Mail and Library Mail options not showing up since 22-Jan-2023 due to the USPS API updates.
  • Tested with WooCommerce 7.3.


  • Avoid ‘Non-numeric value encountered’ PHP warnings on missing product dimensions.
  • Tested with WooCommerce 7.1.
  • Raise the minimum required versions of WordPress and WooCommerce to 4.6 and 3.2 respectively.


  • Tested with WooCommerce 7.0, WordPress 6.1.


  • Tested with WooCommerce 6.9.


  • Fix an error when item quantity is fractional.


  • Workaround a USPS API error for items less than 0.25 inch.
  • Check shipped items dimensions against the First-Class Mail size constraints (if ‘Quote regular items by weight’ is disabled).
  • Avoid an additional call to the USPS API if Retail Ground is disabled.
  • Fill the shipping origin postcode from Store Address by default.
  • Enable the plugin upon install.
  • Remove the ‘(USPS Simple)’ delivery option label suffix.
  • Require PHP 7.2+.
  • Tested with WooCommerce 6.7.


  • Tested with WooCommerce 6.5, WordPress 6.0.


  • Tested with WooCommerce 6.3.


  • Add the ‘First-Class Package Service – Retail’ service.
  • Small backend cosmetic changes.


  • Avoid ‘Non-numeric value encountered’ PHP warnings on missing product dimensions or weight.
  • Tested with WordPress 5.9, WooCommerce 6.1.


  • Replace the default USPS API user id to fix the authorization issue.
  • Tested with WooCommerce 5.6.
  • Fix the debug info drawer won’t expand after cart update.


  • Tested with WooCommerce 5.6.


  • Tested with WordPress 5.8, WooCommerce 5.5.


  • Tested with WooCommerce 5.3.


  • Tested with WooCommerce 5.1, WordPress 5.7.


  • Reword commercial rates description.
  • Refactor USPS API response handling a bit.


  • Check prerequisites on load, in a user-friendly way.


  • Replace the deprecated WC_Product->length/width/height properties access with get_XXX() calls.
  • Switch to the HTTPS USPS API endpoint.
  • Disable cache and show debug data on the cart and checkout pages if the WooCommerce shipping debug mode is enabled.
  • Tested with WooCommerce 4.8, WordPress 5.6.

  • Tested with WooCommerce 4.7.


  • Tested with WooCommerce 4.6.
  • Minor changes for better USPS API response parsing.


  • Tested with WordPress 5.5 and WooCommerce 4.5.
  • Refresh the settings page look a bit.


  • Compatible with woocommerce 2.6


  • Fix First-Class Mail Parcel price calculator.
  • Added First-Class Mail Large Envelope, Letter and Postcards.


  • API Request updated


  • Fix – Incorrect work of «Quote regular items by weight» with zero size items.


  • Removed deprecated USPS services:
    Priority Mail Regional Rate Box C;
    Priority Mail Regional Rate Box C, Hold For Pickup;
  • Added First-Class Mail Metered Letter;
  • Rebranding of Standard Post as Retail Ground.


  • Fix – warning message in cart.


  • Added services:
    Priority Mail, Hold For Pickup;
    Priority Mail Regional Rate Box A, Hold For Pickup;
    Priority Mail Regional Rate Box B, Hold For Pickup;
    Priority Mail Regional Rate Box C, Hold For Pickup.


  • Added mail class id


  • Added grouping by weight.


  • Fix – Standard Post really works.


  • Supported services: Priority Mail Express, Priority Mail, First-Class Mail, Standard Post, Media Mail, Library Mail