Because Portless ships directly from fulfillment centers in China and Vietnam, your customer's address is committed to a label earlier in the process than with a domestic carrier. Getting the format right the first time prevents blocked orders, failed deliveries, and Return-to-Sender events.
How address validation works
When an order syncs into Portless, it goes through an address check before it's pushed to the warehouse. If the address fails, for example, the suburb and postcode don't match for an Australian address, the order is blocked and won't ship until you fix it.
Blocked orders appear as exceptions in the Merchant Portal. If you're using Shopify, updating the address there does not automatically update it on the Portless side. You need to notify support separately. If applicable, you may also update the required details using the Portless Merchant Portal.
If an address passes validation but is still wrong (e.g., one digit off in a ZIP code), the order ships and the carrier attempts delivery. This usually leads to a failed delivery or Return-to-Sender.
Note that numeric-only entries are invalid. The street address must include a specific door or house number where one exists.
Address format by country
United States
Required: Street address, city, 2-letter state abbreviation, 5-digit ZIP code
Common issues: A single wrong digit in the ZIP code is the most common cause of US failed deliveries. Always include apartment or unit numbers in Address Line two.
United Kingdom
Required: Street address, city/town, UK postcode
Postcode format: Alphanumeric, e.g. LS2 7PA or GU6 0JY
Common issues: Wrong postcode entered at checkout. Building or venue names in Address Line 2 are accepted.
UK Cities: It must be 28 characters or fewer and contain only English letters.
Australia
Required: Street address, suburb, state abbreviation (e.g. VIC, NSW), 4-digit postcode
Postcode format: 4 digits. For example, 3809, 6151. Not 5.
Common issues: A suburb/postcode mismatch blocks the order completely. Verify the correct postcode for the suburb using the Australia Post postcode finder before submitting a correction.
Japan
Required: Building/room/floor, street and block, ward (区/ku) and city, prefecture, 7-digit postal code (format: XXX-XXXX)
Common issues: Missing detail at the building or ward level. All lines need to be present: building name/room, block, ward, city, and postal code. Example of a correctly formatted Japanese address:
601 BLESS Sangenjaya EAST
4-3-16 Taishido, Setagaya-ku
Tokyo 154-0004
Japan
Spain
Required: Street name (Line 1), street number + door (Line 2), city, province, 5-digit ZIP
Common issues: Street number and door designator belong in Address Line two, not Line one. Example:
Line 1: Calle de Hernán Cortés
Line 2: 7 Puerta 4th door
City: Mislata | Province: Valencia | ZIP: 46920
Netherlands, Canada, and other markets
Address format generally follows local postal standards. No documented validation errors on file for these countries. If an order blocks with an exception, contact support.
How to correct an address after an order is placed
The window closes once the last-mile tracking number is generated. Act quickly.
Update your store. If you're on Shopify, update the address on the order in your Shopify admin first.
Contact Portless support. Email [email protected] or message via the portal. Include your Portless order number and the full corrected address.
We update it in our Warehouse Management System (WMS). The support team will update the address in the warehouse system and confirm when it's done.
If the order has already shipped, the label can't be changed. Your options are to ask the customer to contact the carrier for an address intercept, or wait to see if the delivery fails and a Return-to-Sender is initiated.
Return-to-Sender
When an order can't be delivered, the carrier returns it to a local warehouse in the destination country, not back to Portless in China or Vietnam. Not all returned orders are eligible for re-dispatch. To know more, please visit our Understanding Return-to-Sender Orders page.
Once the package arrives, Portless will contact you with two options:
Redelivery. Availability depends on the carrier and logistics channel used for the original order
New order. Place a new order. It will ship directly from the Portless warehouse
Who covers the cost? If the RTS was caused by an invalid address, repeated failed delivery attempts, or an unreachable customer, Portless does not cover return or reshipment costs. If the issue was on Portless's end, contact our Customer Support Team.
FAQs
Can I fix an address after the order has been placed? Yes, as long as the order hasn't shipped yet. Update it in your store and contact Portless support with the Portless order number and the full corrected address. We'll update it in the warehouse system. If applicable, you may also take advantage of our self-help options through the Portless Merchant Portal.
I updated the address in Shopify. Is that enough? No. Shopify updates don't automatically sync to Portless for orders already in fulfillment. You need to contact support directly with the corrected address. Or, submit an edit order request through the Portal.
My Australian order is blocked with a "city postcode mismatch" error. What do I do? Check the suburb-to-postcode mapping using the Australia Post postcode finder and send the corrected address to support. Once updated, we'll retry the warehouse push.