> For the complete documentation index, see [llms.txt](https://parcelwill-returns.gitbook.io/help-center/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://parcelwill-returns.gitbook.io/help-center/return-page/add-return-widget-to-customer-account.md).
# Add return widget to customer account
With ParcelWILL (Formerly ParcelPanel) Returns, you can embed a return widget directly into your Shopify customer account pages. This lets logged-in customers start a return from their order history without needing to visit a separate return page or look up their order number.
{% hint style="warning" %}
The customer account return widget is available on the **Essential plan and above**. Free plan users can still add the return page to their [store navigation](/help-center/return-page/add-return-page-to-store-navigation.md) instead.
{% endhint %}
## How it works
When enabled, a **Request return** button appears on the order details page inside your customer's account. Customers click it and are taken directly into the ParcelWILL return flow — they skip the login step since they're already authenticated.
### Enable the return widget
{% stepper %}
{% step %}
### Go to return page settings
Navigate to **ParcelWILL app > Return page** and scroll down to the **Customer account** section.
{% endstep %}
{% step %}
### Enable the widget
There are two types of return widgets
**Return - Order actions**
After this return widget is added, a **Request return** button will appear in the **order action area** on both the **Orders** page and the **Order status** page.
**Return - Standalone widget**
After this return widget is added, **a standalone return section** will appear on the **Order status** page, and you can drag it to adjust its position.
{% endstep %}
{% step %}
### Verify on your storefront
Log in to your store as a customer (or use a test customer account), go to the order history, open a fulfilled order, and confirm that the **Request return** button appears.
{% hint style="success" %}
Done! Your customers can now start returns directly from their account.
{% endhint %}
{% endstep %}
{% endstepper %}
## What your customer sees
When a customer clicks the **Request return** button from their account, they are taken into the ParcelWILL return flow. The experience is the same as submitting a return through the standalone return page, except:
* **No login step** — since the customer is already signed in to their Shopify account, they skip the order lookup and go straight to selecting items to return.
* **Order is pre-loaded** — the return form automatically knows which order the customer is returning from.
The rest of the flow — selecting a return reason, choosing a return solution, and submitting the request — works identically to the standalone return page.
## Customize the customer account widget text
If you've enabled the return widget in customer accounts, you can change the button text and description that appear on the order details page.
{% stepper %}
{% step %}
### Open the widget text settings
Go to **ParcelWILL app > Return page** and scroll down to the **Customer account** section. You'll find the text customization fields here.
{% endstep %}
{% step %}
### Edit the button and description text
You can change two text fields:
* **Button text** — the text shown on the return button (default: "Request return"). For example, you could change it to "Start a return" or "Return this order".
* **Widget description** — the text shown below or next to the button that provides context (e.g., "Need to return or exchange an item? Start here.").
{% endstep %}
{% step %}
### Save your changes
Click **Save** to apply. The updated text will appear immediately on your customer account pages.
{% endstep %}
{% endstepper %}
## Frequently asked questions
Can I use the customer account widget and the standalone return page at the same time?
Yes. They are independent features and can both be active. Some customers will find the return page through your navigation menu, while others will start from their account page. Both paths lead to the same return flow.
What if the customer's order is not eligible for a return?
If the order falls outside your return window or contains blocked products, the **Request return** button will either not appear or will show a message explaining why the return cannot be submitted. This follows the same eligibility rules you configured in **ParcelWILL app > Settings > Return rules**.
## Need help?
🌻 If you have any questions, feel free to reach out to [our support team](mailto:returns@parcelpanel.ltd).
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://parcelwill-returns.gitbook.io/help-center/return-page/add-return-widget-to-customer-account.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.