Documentation
ReturnDesk
Troubleshooting

Troubleshooting

Returns Tab Shows "Page Not Found"

Flush rewrite rules

Visit Settings → Permalinks and click Save Changes.

Verify login state

The Returns tab is part of My Account, so the customer must be logged in. Guests should use the Return Center.


No Return Option on an Order

Check the master toggle

Confirm Enable Returns is on under WooCommerce → ReturnDesk → General → Return Settings.

Check the order status

The order's status must be in Allowed Order Statuses.

Check the return window

The order must be within Return Window (days) of its completion date.

Check sale items and earlier requests

Sale items are only returnable if Allow Returns For Sale Products is on, and items already covered by a pending or approved request can't be requested again. The reason is shown next to each item.


Emails Not Sending

Check the email toggles

Under Advanced → Email Notifications, make sure the relevant email is enabled.

Send a test email

Choose the template under Email Type and use Send a test email to send it to your address.

Check your mail setup

If test emails don't arrive, your site's mail sending needs attention. Install an SMTP plugin (for example WP Mail SMTP) and check its email log.


Guest Can't Find Their Order

The Return Center needs the order number and the billing email used on that order. Check both for typos - the email must match exactly (letter case doesn't matter).


Upload Fails

Attachments must be JPG, JPEG, PNG, WebP or PDF, and each file must be within your server's maximum upload size. Ask your host to increase the upload limit if needed.


"A request already exists for full quantity"

This is expected when a pending or approved request already covers the full quantity of an item. If the earlier request was rejected or cancelled, the customer can submit a new one.