After July 2021, the 2.3.x release line no longer received quality updates or user guide updates. PHP 7.3 reached end of support in December 2021, and Adobe Commerce 2.3.x reached end of support in September 2022. We strongly recommend upgrading to Adobe Commerce 2.4.x to help maintain PCI compliance.

Creating Shipping Labels

This site contains archived merchant documentation for a version of Adobe Commerce and Magento Open Source that has reached end-of-support. The documentation available here is intended for historical reference only and is not maintained. The Adobe Commerce Merchant Documentation for current releases is published on the Adobe Experience League.

To create shipping labels, you must first set up your shipping carrier account to support labels. Then, follow the prompts to enter a description of the package and its contents.

After you configure the shipping label information and submit an order, Magento connects to the shipping carrier system, submits an order, and receives a shipping label and a tracking number. If a shipping label for this shipment already exists in the system, it is replaced with a new one. However, existing tracking numbers are not replaced. Any new tracking number is added to the existing one.

Step 1: Contact your shipping carriers

Before you begin, make sure that your shipping accounts are set up to process labels. Some carriers might charge an additional fee to add shipping labels to your account.

Follow the instructions provided by each carrier to add shipping label support to your account.

FedEx Contact FedEx Web Services regarding their label evaluation process.
USPS Contact uspstechsupport@esecurecare.net to request that API Signature Confirmation V3 be enabled for your live USPS API Access account.
UPS Contact UPS to confirm your account type supports shipping labels. To generate shipping labels, you must use the UPS XML option.
DHL Contact the DHL Resource Center to learn more about their services or send an inquiry through their Contact Center.

Step 2: Update the configuration for each carrier

Required carrier configuration settings

Field Description
Type Package types differ by carrier and method. The default package type for each carrier is initially selected. USPS does not require the package type for domestic shipments.
Customs Value (International shipments only) The declared value or sales price of the contents of an international shipment.
Total Weight The total weight of all products added to the package is calculated automatically. The value can also be changed manually, and entered as pounds or kilograms.
Length, Width, Height (Optional) The package dimensions are used for custom packages only. You can specify the measurements units as inches or centimeters.

Not Required: No confirmation of delivery is sent to the store by the shipping carrier.

No Signature: A delivery confirmation without the signature of the recipient is sent to the store by the shipping carrier.

Signature Required: The shipping carrier obtains the signature of the recipient and provides the store with a printed copy.

Direct: (FedEx Only) FedEx obtains a signature from someone at the delivery address. If no one is available to sign for the package, the carrier tries to deliver the package at another time.

Indirect: (FedEx Residential Deliveries Only) FedEx obtains the signature of someone, possibly a neighbor or building manager, at the delivery address. The recipient can leave a signed FedEx door tag to authorize the package to be left without anyone present to sign for it.

Contents: (USPS Only) Select one of the following descriptions of the package:
- Gift
- Documents
- Commercial Sample
- Returned Goods
- Merchandise
- Other

Explanation: (USPS Only) A detailed description of the package contents.

Adult Required: The shipping carrier obtains the signature of an adult recipient and provides the store with a printed copy.

  1. Make sure that your Store Information is complete.

  2. On the Admin sidebar, go to Stores > Settings > Configuration.

  3. In the left panel, expand Sales and select Shipping Settings.

  4. Expand Expansion selector the Origin section and configure the Shipping Origin Address.

  5. Follow the instructions for each carrier account that is activated for label printing.

UPS configuration

United Parcel Service ships both domestically and internationally. However, shipping labels can be generated only for shipments that originate within the United States.

  1. In the Sales section in the left panel, choose Shipping Methods.

  2. Expand the UPS section.

  3. Verify that your UPS Shipper Number is correct

    Your shipper number appears only when United Parcel Service XML is enabled.

  4. Click Save Config.

USPS configuration

The United States Postal Service ships both domestically and internationally.

  1. Continuing in the Shipping Methods configuration, expand the USPS section.

  2. Verify that the secure Gateway URL is entered.

    The correct URL should be entered automatically.

  3. Enter the Password provided to you by USPS.

  4. Set Size to Large and enter values for the following dimensions:

    • Length
    • Width
    • Height
    • Girth

  5. Click Save Config.

FedEx configuration

FedEx ships domestically and internationally. Stores located outside the United States can create FedEx labels for international shipments only.

  1. Continuing in the Shipping Methods configuration, expand the FedEx section.

  2. Verify that the following FedEx credentials are correct:

    • Meter Number
    • Key
    • Password

  3. Click Save Config.

DHL configuration

DHL provides international shipping services.

  1. Continuing in the Shipping Methods configuration, expand the DHL section.

  2. Verify that the Gateway URL is entered.

    The correct URL should be entered automatically.

  3. Verify that the following credentials are complete:

    • Access ID
    • Password
    • Account Number

  4. Click Save Config.

Step 3 Create shipping labels

Method 1: Create label for new shipment

  1. On the Admin sidebar, go to Sales > Orders.

  2. Find the order in the grid and open the record.

    The status of the order must be either Pending or Processing to submit a new shipment.

  3. In the upper-right corner, click Ship.

  4. Confirm the shipping information according to carrier requirements.

  5. In the lower-right corner, select the Create Shipping Label checkbox.

  6. Click Submit Shipment.

  7. Add or update products in package:

    • To add products from the order to the package, click Add Products. The Quantity column shows the maximum number of products that are available for the package. Select the checkbox of each product to be added to the package and enter the Quantity of each. Then, click Add Selected Product(s) to Package.

    • To add a new package, click Add Package.

    • To delete a package, click Delete Package.

    If you use a package type other than the default, or require a signature, the cost of shipping might differ from what you have charged the customer. Any difference in the cost of shipping is not reflected in your store.

  8. Click OK.

    The system connects to the shipping carrier system, submits the order, and receives a shipping label and tracking number for each package.

If you cancel an order by clicking Cancel, a shipping label will not be created, and the Create Shipping Label checkbox is cleared.

Method 2: Create label for an existing shipment

  1. On the Admin sidebar, go to Sales > Orders.

  2. Find the order in the grid, and open the Shipping form.

  3. In the Shipping and Tracking Information section, click Create Shipping Label.

  4. Distribute the ordered product(s) to the appropriate package(s), and click OK.

  5. To review the package information, click Show Packages.

Step 4: Print the Labels

Shipping labels are generated in PDF format, and can be printed from the Admin. Each label includes the order number and package number.

Because an individual shipment order for each package is created, multiple shipping labels might be received for a single shipment.

Method 1: Print a label from the shipment form

  1. Open the shipment form using one of the following methods:

    • On the Admin sidebar, choose Sales > Orders. Find the order in the grid and open the record. In the left panel, choose Shipments. Then, open the shipment record.

    • On the Admin sidebar, choose Sales > Shipments. Find the order in the grid and open the record.

  2. To download the PDF file, go to the Shipping and Tracking section and click Print Shipping Label.

    Depending on your browser settings, the shipping labels can be viewed and printed directly from the PDF file.

    The Print Shipping Label button appears only after the carrier generates labels for the shipment. If the button is missing, click Create Shipping Label. The button appears after Magento receives the label from the carrier.

Method 2: Print labels for multiple orders

  1. Open a list of shipments using one of the following methods:

    • On the Admin sidebar, choose Sales > Shipments.
    • On the Admin sidebar, choose Sales > Orders.

  2. Select the checkbox of each shipment label to be printed, or for each order with shipping labels to be printed.

  3. Click the Actions control and choose Print Shipping Labels.

  4. Click Submit.

A complete set of shipping labels is printed for each shipment that is related to the selected orders.

© 2024 Adobe. All rights reserved.