Shipping and Return Labels

Set Up Shippo for Return Shipping Labels

Updated Oct 9, 2026

This article shows you how to connect Shippo so it appears as an option when you generate return shipping labels for customers, how to default those labels to scan-based billing, and how to store your Shippo API key securely.

Plan requirements

The Shippo integration requires the Advanced plan. Until your store is on the Advanced plan, the Shippo toggle, API key field, and scan-based option are all disabled.

How it works

The Shippo settings unlock in sequence:

  1. Turning on Show Shippo in my Return Shipping Label options makes Shippo appear as a choice when generating return shipping labels. While it is OFF, Shippo is hidden from your Return Shipping Label options.
  2. Only once Shippo is active do the Shippo API Key field and the scan-based label option become editable.
  3. Your API key is encrypted when settings are saved.

Set it up

  1. Go to Integrations > Shipping > Shippo Integration.
  2. Turn on Show Shippo in my Return Shipping Label options. This is OFF by default.
  3. In the Shippo API Key field, paste the API key from your Shippo account. The key is empty by default and is encrypted when you save.
  4. (Optional) Turn on Default to scan-based return labels for USPS, FedEx, and UPS (charge only when scanned) so you're only billed when a label is actually scanned by the carrier. This is OFF by default, and you can override it per return when needed.
  5. Save your settings.

Updating an existing API key

If a key is already stored, the Shippo API Key field displays masked dots rather than the real value. To change it, clear the field completely, enter the new key, and save again.

Troubleshooting

  • The Shippo checkbox is greyed out: Your store must be on the Advanced plan for the Shippo integration to be editable.
  • The API key and scan-based options won't let you type: Turn on Show Shippo in my Return Shipping Label options first — these fields only become editable once Shippo is active.
  • Your updated key doesn't seem to take effect: Make sure you cleared the masked field entirely before entering the new key, then save.

Related articles