USPS – General Settings

You can reach the plugin settings by choosing the WooCommerce → Settings → Shipping → USPS Live Rates from the sidebar.

API Settings

In order to offer your customers the available USPS services based on the order details and display them in the cart and checkout, you need to own a USPS account with USPS Web Tools API access granted and enter your USPS Web Tools API USERID acquired during the registration process in the plugin settings.

If you do not have a USERID yet, register for USPS Web Tools now or follow the instructions from our guide on how to obtain the USPS Web Tools API access →


– fill in this field with the credentials you acquired during the USPS account registration process.

PRO Custom Origin

– use this option to use the different shipper’s address to calculate the live rates than the one defined in the WooCommerce settings. It is especially useful e.g. when you ship the products directly from the warehouse located in a different place than your shop’s address.

If not enabled, the address you’ve entered at WooCommerce → Settings → General → Store Address will be used by default. If ticked, the additional Origin AddressOrigin CityOrigin Postcode and Origin Country/State fields will appear below.

Please be advised that each shipping method that uses USPS plugin can have its own Custom Origin. To learn more about Multiple Custom Origins feature – read this article →

Advanced Options

Debug Mode

– enabling the Debug Mode will let you identify and analyze the problems with USPS services price calculation. The additional tech information, incl. the data sent to USPS API, all the requests, responses and the error messages coming back from the USPS API will be displayed in the cart and on the checkout page:

All the notices and data coming from enabled Debug Mode will be visible only for the Site Administrators and Shop Managers. Your customers, no matter if they are guests or logged in, won’t see any unnecessary info on the shop’s front.

API Connection Status

– once your login credentials were entered and Save changes button hit, the API Connection Status should change to OK and turn green.

If for some reason the plugin is not able to establish the connection with the USPS API, you will see the error message coming from the API with the detailed information on the cause of the problem, e.g.:

Scroll to Top