Documentation
ReturnDesk
Troubleshooting

Troubleshooting

Returns Tab Not Appearing in My Account

Flush rewrite rules

Visit Settings → Permalinks and click Save Changes to flush rewrite rules.

Check the master toggle

Confirm Enable Returns is set to Yes in ReturnDesk settings.

Verify login state

Check that the customer is logged in - the tab is hidden for guests.


Customer Cannot Select Any Orders

Check order status

Verify the order status is in the Allowed Order Statuses list.

Check the return window

Confirm the order is within the Return Window days.

Check for prior requests

Check that the items have not already been fully requested.


Emails Not Sending

Test email

Go to any request and click the Send Test Email button on the relevant template.

Check WooCommerce email config

If test emails work but real emails don't, check your WooCommerce email sending configuration.

Install a logging plugin

Install a logging plugin (e.g., WP Mail SMTP with logging) to capture failed sends.


Return Window Showing Incorrect Date

Check WordPress timezone

Confirm your WordPress timezone is set correctly under Settings → General → Timezone.

Verify order completion date

The return window is calculated server-side using the order's date_completed field; ensure WooCommerce is updating this field when orders complete.


"You have already requested a return for this item" Error

This is expected behaviour when the full quantity of an item already has a pending or approved request. If the previous request was rejected or cancelled, the customer can re-submit.