# FedEx troubleshooting
URL: https://support.starshipit.com/articles/90200000000124-fedex-troubleshooting
Canonical: https://support.starshipit.com/articles/90200000000124-fedex-troubleshooting
Markdown: https://support.starshipit.com/articles/90200000000124-fedex-troubleshooting.md
Updated: 2026-06-14

> For the complete documentation index, see [llms.txt](https://support.starshipit.com/llms.txt).

> Fix common FedEx registration, product code, and image upload errors in Starshipit.

Use these checks when FedEx registration, service selection, or image upload fails in Starshipit.

## Internal Service Error during authentication

This error can appear when your FedEx street address is too long. FedEx requires the street address to be fewer than 35 characters.

1. Go to **Settings > Pickup address**.
2. Shorten the street address so it is fewer than 35 characters.
3. Save the address.
4. Go to **Settings > Couriers > FedEx**.
5. Try registration again.

## FedEx Economy does not appear

If `FEDEX_INTERNATIONAL_ECONOMY` does not return on orders, use `INTERNATIONAL_ECONOMY` as the product code instead.

After updating the product code, create or open a test order and check that the expected FedEx Economy service appears.

## Unexpected Error when uploading an image

If you see an **Unexpected Error** message when uploading a signature or letterhead image, check that sandbox mode is disabled.

1. Go to **Settings > Couriers > FedEx**.
2. Untick **Use Sandbox URL**.
3. Save your FedEx settings.
4. Upload the image again.

## Related articles

- [How to set up FedEx](/articles/couriers/fedex/how-to-set-up-fedex)
- [FedEx product codes and packaging](/articles/couriers/fedex/fedex-product-codes-and-packaging)
- [FedEx additional settings](/articles/couriers/fedex/fedex-additional-settings)