--- title: "UPS Shipping" description: "This plugin integrates the UPS Shipping Rate API with J2Commerce." url: "https://docs.j2commerce.com/shipping-methods/ups-shipping" markdown_url: "https://docs.j2commerce.com/shipping-methods/ups-shipping.md" last_updated: "2026-10-23T02:33:38+00:00" version: "J2Store 4" breadcrumbs: - title: "Home" url: "https://docs.j2commerce.com/" - title: "Shipping Methods" url: "https://docs.j2commerce.com/shipping-methods" - title: "UPS Shipping" url: "https://docs.j2commerce.com/shipping-methods/ups-shipping" --- # UPS Shipping This plugin integrates the UPS Shipping Rate API with J2Commerce. **Requirements** - with PHP 8.1.0 + - Joomla! 4.x/ Joomla! 5.x + - J2Commerce / J2Store 4.x + #### **Configuration:** Prior to configuring the plugin, you should have an active account with UPS and have received API keys. Contact UPS to register and get API keys. #### Installation: You can install this USP shipping plugin using Joomla installer. The following steps help you with a successful installation. **Step 1:** Go to our [J2Commerce website](https://www.j2commerce.com/extensions) > Extensions > Shipping Plugin ![J2Commerce website Extensions > Shipping Plugins page with Extensions, the Shipping tab and the UPS Shipping card ($34.99) highlighted](https://docs.j2commerce.com/images/docs/shared/ups-purchase.webp) **Step 2:** Locate the UPS App > click View Details > Add to cart > Checkout. **Step 3:** Go to your My Downloads under your profile button at the top right corner and search for the app. Click Available Versions > View Files > Download Now ![J2Commerce website My Downloads page searching shipping, with the UPS row and its Available Versions button highlighted](https://docs.j2commerce.com/images/docs/shared/ups-download.webp) **Installation:** You can install this UPS shipping plugin using Joomla installer. The following steps help you for successful installation. **Step 1:** In the Joomla admin, go to System > Install > Extensions ![Install extensions](https://docs.j2commerce.com/images/docs/v4/assets/app%20install1%20%281%29%20%281%29.webp) **Step 2**: Click on the Browse button and select the UPS Shipping zip file you saved during the download process. You will receive a message of success once installed. ![app install](https://docs.j2commerce.com/images/docs/v4/assets/ups-download.webp) **Step 3:** Select J2Commerce > setup > shipping methods ![shipping method](https://docs.j2commerce.com/images/docs/v4/assets/ups-setup-shipping%20%282%29.webp) **Step 4:** - Now, the UPS shipping for J2Commerce page will appear on the screen. - Enable the plugin by clicking on the 'X'. - Configure the shipping plugin by entering the plugin parameters. ![Parameters](https://docs.j2commerce.com/images/docs/v4/assets/ups-perameters2.webp) #### Plugin Settings: **Client Key:** Client Key provided by the UPS Developer Portal ([https://developer.ups.com/](https://developer.ups.com/)). **Client Secret:** Client Secret provided by the UPS Developer Portal ([https://developer.ups.com/](https://developer.ups.com/)). **Shipper Number:** Enter the UPS account Shipper number ![Plugins: UPS Shipping, enabled, with the Toggle Inline Help button highlighted and Client Key and Client Secret fields showing inline help text](https://docs.j2commerce.com/images/docs/v4/assets/ups-perameters1%20%281%29.webp) **Parcel Packing Method:** You may select the parcel method for packing the products. **UPS Packaging Box:** You may consider selecting the available UPS box. Note: If you choose Pack into boxes with weights and dimensions (Recommended) but have not chosen any UPS Packaging, nor defined any custom boxes (as explained below), the plugin displays the error message: “UPS is enabled, and Parcel Packing Method is set to ‘Pack into boxes’, but no UPS Packaging is selected and there are no custom boxes defined. Items will be packed individually.” **Custom Box:** You may enter the dimensions here the items will be packed into these boxes based on item dimension and volume. Outer dimension will be passed to UPS, whereas the inner dimension will be used for packing. Items not fitting into boxes will be packed individually. This Custom Box is to be chosen only when “Box packing” is selected. **Handling Cost:** Apply an additional fee to the shipping cost calculated. **Send Product Amount to UPS:** Select Yes to send the product price to UPS. **Enable Negotiated Rate:** Set this to Yes for negotiated rate. **Delivery Confirmation Option:** You can confirm the delivery using a signature with UPS. **Services:** Select the UPS services to be offered. **Pickup Type:** Choose the required pickup type here. **Weight Unit:** Select if you want the weight set as grams, pounds, kilograms, or ounces. **Show Weight Total:** Set this to Yes to show the weight total next to the shipping service name. **Show Delivery Date:** Set this to yes to show the delivery date next to the shipping service name. The delivery times are provided by the UPS API for shipping services that specify specific delivery days, such as Next Day Air, Second Day Air, etc. ![Show delivery date](https://docs.j2commerce.com/images/docs/v4/assets/ups-perameters4.webp) ![Delivery date examples](https://docs.j2commerce.com/images/docs/v4/assets/ups-perameters5%20%282%29.webp) **Length Unit:** If you have not set the length unit in the product, the value selected here will be used. Inch vs cm **Tax Class:** Here, you can specify the Tax class to charge the Tax on shipping. Leave empty if you do not want to charge tax. **Geozone:** If you choose a Geozone, then this shipping plugin will apply only to customers coming from the countries/zones added under the chosen Geozone. Leave empty to show the method to all Geozones. **Shipping Origin Address Type:** If your origin shipping address is a home, then change to residential. **Shipping Origin Address:** Enter the address from which you ship. **Shipping Origin City:** Enter the city from which you ship. **Shipping Origin Zin/Postalcode:** Enter the Postcode from where you ship. **Country:** Select the Country from which you ship. **Zone:** Select the Zone/State from which you ship. **Debug:** If you set this to Yes, the system will log the requests and responses, which will help you debug. The logs will be saved in the Cache folder. **Note:** In the production environment, it must be set to NO. ## How to obtain UPS OAuth Credentials: The following instructions will help walk you through the process of obtaining your new UPS OAuth Client ID and Client Secret. **Step 1:** Go to ([https://developer.ups.com/](https://developer.ups.com/)) and log in. **Step 2:** Click My Apps in the top right corner **Step 3:** Click Add Apps in the bottom left corner ![Add apps](https://docs.j2commerce.com/images/docs/v4/assets/ups-add-apps.webp) **Step 4:** Then, I need API credentials because I want to integrate UPS technology into my business. **Step 5:** On the same page as #4: Select the client's UPS account you need to link it to ![UPS developer portal create-app form: My Apps link, the I want to integrate UPS technology into my business option, and the account selector highlighted (account hidden)](https://docs.j2commerce.com/images/docs/v4/assets/ups-add-account.webp) **Step 6:** Complete the contact info **Step 7:** Then select the Rating, Tracking, and Time In Transit API's (I believe the Authorization(OAuth) is automatically added when you save) (Right now, we aren't using the Tracking API, but we do plan on incorporating that in later versions, so better to add it now so you don't need to worry about adding it later...) ![API's](https://docs.j2commerce.com/images/docs/v4/assets/ups-api.webp) **Step 8:** After saving, you should be able to see the Client ID and client Secret under the App Info/Credentials page ![UPS developer portal app page: Client ID and Secret hidden, with Authorization (OAuth), Rating, Time In Transit and Tracking APIs highlighted, all Approved](https://docs.j2commerce.com/images/docs/v4/assets/ups-approval.webp)