# Colour options
Source: https://docs.clevyre.com/accessibility-widget/customization/colour
Select the primary colour for the Accessibility Widget
## Overview
Select the colour you want to display the widget in. The colour applies to the widget icon and the expanded panel.
## Colour picker
Use the colour swatch to choose a colour visually. Click the swatch to open the colour picker and select any colour.
## Hex code input
You can also enter a hex code directly in the text field below the colour swatch. For example, `#086D39` displays a green widget. This is useful when you want to match a specific brand colour.
Use your store's primary or accent colour to keep the widget consistent with your branding.
# Icon options
Source: https://docs.clevyre.com/accessibility-widget/customization/icon
Customize the icon size and shape for the Accessibility Widget
## Overview
Select the icon you want to display for the widget. You can change both the size and the shape of the icon.
## Size
Use the **Size** dropdown to choose how large the widget icon appears:
* **Small** — A compact icon for minimal visual impact
* **Medium** — The default size, balanced for most stores
* **Large** — A larger icon for easier visibility
## Shape
Choose from four icon shapes:
1. **Stick figure** — A simple person icon
2. **Accessibility symbol** — A person with outstretched arms (the universal accessibility symbol)
3. **Wheelchair** — The international symbol of access
4. **Wheelchair with arrow** — A dynamic wheelchair symbol
The selected icon is highlighted in the customization panel. Click any icon to change the widget's appearance.
# Language options
Source: https://docs.clevyre.com/accessibility-widget/customization/language
Select the language for the Accessibility Widget interface
## Overview
Select the language you want to display the widget in. The widget's labels, buttons, and tooltips use the selected language.
## Language dropdown
Use the **Widget language** dropdown to choose a language. For example, **English (English)** displays the widget interface in English. The list includes all supported languages for the widget.
Choose a language that matches your store's primary audience. The widget language is independent of your Shopify store language.
# Overview
Source: https://docs.clevyre.com/accessibility-widget/customization/overview
Customize the appearance and behaviour of your Accessibility Widget
## Overview
You can customize the Accessibility Widget to match your store's branding and layout. The customization panel lets you change the colour, icon, position, and language of the widget. A live preview updates as you make changes.
## Customization interface
The customization page shows all options on the left and a live preview on the right. You can switch between desktop and mobile views to see how the widget looks on different devices.
## Options at a glance
Select the primary colour for the widget.
Choose the icon size and shape.
Set where the widget appears on desktop and mobile.
Select the language for the widget interface.
# Position controls
Source: https://docs.clevyre.com/accessibility-widget/customization/position
Set where the Accessibility Widget appears on your storefront
## Overview
Select the position you want to display the widget in. You can set different positions for desktop and mobile views.
## Desktop and mobile
Use the **Desktop** and **Mobile** tabs to configure the widget position for each device type. The widget can appear in different corners on desktop vs mobile.
## Position grid
The position grid shows four corner options:
* Top-left
* Top-right
* Bottom-left
* Bottom-right
Click the radio button for the corner where you want the widget to appear. The bottom-right is the default position.
## Fine-tune position
Adjust margins to perfectly position your widget. Use the sliders or enter values in the text fields:
* **Vertical (Max 80px)** — Adjust the vertical spacing from the edge of the screen
* **Horizontal (Max 80px)** — Adjust the horizontal spacing from the edge of the screen
These settings help you align the widget with other elements on your storefront or avoid overlapping content.
# Quickstart
Source: https://docs.clevyre.com/accessibility-widget/quickstart
Get the Accessibility Widget on your Shopify store in minutes
## Overview
Get the Accessibility Widget on your Shopify store in minutes. Follow these steps to install the app, enable the widget, and make it visible on your storefront.
## Install from the Shopify App Store
1. Go to the [Shopify App Store](PLACEHOLDER_URL) and find the web-accessibility app.
2. Click **Add app** to install it on your store.
3. The installation process is the same as for other Shopify apps.
## Approve permissions
During installation, Shopify asks you to approve the permissions the app needs. Review the requested access and click **Install app** to continue.
## Land in the app
After you approve the permissions, you land in the web-accessibility app dashboard.
## Enable the app embed
When you first open the app, you see a notice that the Accessibility Widget is not active.
Click **Enable widget** to continue.
## Save your theme changes
Clicking **Enable widget** redirects you to the **App embeds** section of your active theme in the Shopify theme editor. The Accessibility Widget app embed is enabled by default.
Click **Save** in the top right to apply the changes.
## Widget visible on storefront
Once you save, the Accessibility Widget appears on your storefront. You can find it in the corner you selected (by default, the bottom-right).
## Next steps
Change the colour, icon, position, and language to match your store.
# The customer experience
Source: https://docs.clevyre.com/eu-withdrawal-button/customer-experience
What your shoppers see and do when they withdraw from an order
## Overview
This page walks through exactly what a customer experiences when they cancel an order. Understanding
this flow helps you support customers and answer their questions with confidence.
The whole process is a short, guided form. The customer never needs an account or any technical
knowledge — just their order number and email address.
## Where the button appears
A floating pill-shaped button sits in the corner of your storefront on every page. By default it says
**"Withdraw from contract"** and sits in the bottom-right corner. You can change its text, colour,
size, and position in [Settings](/eu-withdrawal-button/settings/button-appearance).
When a customer clicks it, they're taken to the withdrawal page (at a web address like
`yourstore.com/apps/withdrawal`).
## The withdrawal steps
The customer enters their **order number** and **email address**. The app finds the matching
order and checks that it's still eligible for withdrawal.
If they can't find their order number, they can choose **"Submit a manual withdrawal
declaration"** instead (see below).
The customer sees every item in their order with its image, options, quantity, and price. They
select how many of each item they want to withdraw — they can cancel the whole order or just part
of it.
They can also confirm their name and add an optional reason. (By law a reason is never required.)
Any items that are exempt from withdrawal are clearly marked and can't be selected.
The customer sees a summary of what they're withdrawing and the total value, along with the
legally required statement based on the EU model withdrawal form:
> *"I hereby give notice that I withdraw from my contract of sale of the following goods…"*
They click **Confirm withdrawal** to submit.
The customer sees a **"Withdrawal confirmed"** page with their **reference number**
(e.g. `WD-2026-0001`), the date, the items, and the value. They can **print or save** this page.
A confirmation email is also sent to their address — this email is the durable legal record of the
withdrawal.
## What gets checked automatically
Before a customer can withdraw, the app quietly confirms a few things so you don't have to:
The order number and email must match a real order in your store. This prevents someone
withdrawing an order that isn't theirs.
The cooling-off period (14 days by default) is measured from delivery. If Shopify doesn't have an
exact delivery date, the app estimates it from the ship date plus your delivery estimate. If the
window has passed, the customer is told the period has ended.
Certain orders are exempt under EU law — for example business-to-business (B2B) orders,
subscriptions, and some digital goods delivered instantly. These are skipped automatically.
If a withdrawal has already been submitted for the order, the customer can't submit a duplicate.
## The manual declaration fallback
Sometimes a customer can't find their order number, or the order isn't in your store's system. For
these cases there's a **manual declaration** option.
The customer fills in an order reference (any identifier they have), their email and name, and a short
description of the goods or service. This creates a withdrawal record that isn't linked to a specific
Shopify order, so you can still review and respond to it.
Manual declarations skip the automatic order checks because there's no matching order to check
against. Review these requests carefully in your admin.
## After the customer confirms
As soon as the customer confirms:
* They receive the **confirmation email** with their declaration and reference number.
* **You receive a notification email** so you know a withdrawal has come in.
* A new entry appears in your [Withdrawals list](/eu-withdrawal-button/managing/withdrawals-list)
ready for you to process.
## Next steps
See how requests appear in your admin and how to process them.
# The home dashboard
Source: https://docs.clevyre.com/eu-withdrawal-button/managing/dashboard
Your at-a-glance view of withdrawal activity
## Overview
The home dashboard is the first page you see when you open the app. It gives you a quick summary of
your withdrawal activity and a shortcut to the most recent requests.
## What's on the dashboard
When the app isn't fully set up, a guide at the top shows the remaining step — enabling the
withdrawal button in your theme. Once you've done that, the guide marks itself complete. See the
[Quickstart](/eu-withdrawal-button/quickstart) for details.
A set of numbers summarizing your withdrawals at a glance:
| Metric | Meaning |
| ------------------ | ------------------------------------------------------------ |
| **Total requests** | Every withdrawal request received. |
| **Pending** | Requests still waiting for you to process. |
| **Completed** | Requests you've marked as completed. |
| **Verified** | Requests where the confirmation email was sent successfully. |
A short table of the **5 most recent** requests, showing the reference number, order, customer,
status, amount, country, and date. Click any row to open its full details.
A help card with links to documentation and support if you need a hand.
## Next steps
Browse the full, paginated list of every request.
Open a request to review items, statuses, and the event timeline.
# Processing a withdrawal
Source: https://docs.clevyre.com/eu-withdrawal-button/managing/withdrawal-detail
Review a request, understand its statuses, and track your progress
## Overview
Open any request (from the dashboard or the [withdrawals list](/eu-withdrawal-button/managing/withdrawals-list))
to see its full details. This is where you review what the customer asked for, track where you are
with it, and — if needed — resend the confirmation email.
## What's on the detail page
The page is organized into clear sections:
The order number (a link to the order in Shopify), the total amount, and the currency.
The customer's name (a link to their Shopify profile), email, language, and country. If the
customer's data has been removed for GDPR reasons, that's noted here.
A table of the products being withdrawn — image, title, options, the quantity withdrawn versus the
quantity ordered, and the line price.
The reason the customer gave, if they chose to provide one.
A complete, time-stamped log of everything that happened — declaration submitted, confirmation
submitted, emails sent or failed, status changes, and more. This is your audit trail.
At the top of the page you'll also find a **Resend confirmation email** button, useful if the
original email didn't reach the customer.
## Understanding the two statuses
Each withdrawal has **two** kinds of status. It's important to understand the difference.
Set **automatically** by the app. It reflects where the customer is in the legal withdrawal
process — you don't change this yourself.
Set **by you**. It tracks your own internal handling of the request — separate from the legal
process.
### Compliance status
This is the app's automatic record of the request's progress:
| Status | Meaning |
| ----------------------------- | -------------------------------------------------------------------------------- |
| **Declared** | The customer started the request but hasn't confirmed yet. |
| **Confirmed** | The customer confirmed the withdrawal. |
| **Confirmation sent** | The confirmation email was delivered successfully — the legally binding record. |
| **Confirmation email failed** | The email couldn't be delivered. Use **Resend confirmation email** to try again. |
| **Abandoned** | The request was started but never completed. |
| **Redacted (GDPR)** | The customer's personal data was removed following a GDPR request. |
### Processing status
This is your own tracking of where you are with the request. Choose a status from the dropdown and
click **Save status**:
| Status | Use it when… |
| --------------- | ------------------------------------------------------------------- |
| **In progress** | You're reviewing or handling the request (this is the default). |
| **Completed** | You've finished — for example, you've issued the refund. |
| **Rejected** | You've declined the request, e.g. it turned out to be out of scope. |
The **Pending** and **Completed** counts on the home dashboard are based on the processing status —
so keeping these up to date keeps your dashboard accurate.
## A typical processing flow
Click into the withdrawal from the dashboard or list.
Check the items, quantities, value, and reason. Confirm the compliance status shows
*Confirmation sent*.
Use the linked order to process a refund through Shopify as you normally would.
Set the status to **Completed** (or **Rejected** if you're declining) and click **Save status**.
## A note on records
Confirmation emails and the event timeline together form your proof that withdrawals were handled
correctly. Keep these records in case you ever need to demonstrate compliance.
Control who gets alerted and how confirmation emails are sent.
# The withdrawals list
Source: https://docs.clevyre.com/eu-withdrawal-button/managing/withdrawals-list
Browse, open, and archive every withdrawal request
## Overview
The **Withdrawals** page lists every request your store has received. It's where you'll spend most of
your time managing day-to-day withdrawals.
## What the list shows
The list shows 25 requests per page, with the newest first. Each row includes:
| Column | What it shows |
| ------------- | ---------------------------------------------------------------------------------------------------------------------- |
| **Reference** | The unique ID for the request, e.g. `WD-2026-0001`. |
| **Order** | The related Shopify order number. |
| **Customer** | The customer's name. |
| **Status** | A badge showing the request's [compliance status](/eu-withdrawal-button/managing/withdrawal-detail#compliance-status). |
| **Amount** | The total value being withdrawn. |
| **Country** | The customer's country. |
| **Date** | When the request was submitted. |
## Actions on each row
Opens the full details of the request — items, statuses, and the complete event timeline.
Archives the request so it no longer appears in the list. The record is retained behind the scenes
for compliance purposes rather than permanently erased.
If no withdrawals have been received yet, the page shows an empty state. New requests appear here
automatically as customers submit them.
## Next steps
Learn what's on the detail page and how to process a request.
# What is the EU Withdrawal Button?
Source: https://docs.clevyre.com/eu-withdrawal-button/overview
Understand the EU right of withdrawal and how this app helps your store comply
## Overview
The **EU Withdrawal Button** adds a simple, legally compliant way for your customers to cancel
("withdraw from") their orders within the cooling-off period required by EU law.
It places a small floating button on your storefront. When a shopper clicks it, the app walks them
through a short form that records their cancellation request, sends them a confirmation email, and
stores a tidy record for you inside the Shopify admin.
You don't need to know anything about Shopify apps or EU law to use it — this page explains both in
plain language.
## What is the "right of withdrawal"?
In the European Union, online shoppers have a legal **right of withdrawal**. This comes from an EU
law called the *Consumer Rights Directive (2011/83/EU)*.
In simple terms:
A customer who buys online can change their mind and cancel the order within **14 days** of
receiving it — **without giving any reason**. This is often called the *cooling-off period*.
To comply with this law, stores must give customers a **clear and easy way** to declare that they
are withdrawing. The EU even publishes a standard "model withdrawal form" that the wording should be
based on. The EU Withdrawal Button does this for you automatically.
This app helps you offer a compliant withdrawal process. It is not legal advice. If you are unsure
about your obligations, check with a legal professional for your specific situation.
## Why use this app?
Without a dedicated tool, customers usually email or call to cancel, and you track everything by
hand. That's slow, easy to get wrong, and hard to prove if a regulator ever asks. This app:
A visible button and a guided, step-by-step form — no confusion about how to cancel.
Every confirmed withdrawal triggers a confirmation email — the durable record the law expects.
Every request is logged with a reference number, timeline of events, and the exact items.
It automatically checks the 14-day window and skips orders that are exempt.
## How it works at a glance
The floating **"Withdraw from contract"** button appears on your storefront. The customer looks
up their order with their order number and email.
They pick which items (and how many) they want to withdraw, optionally add a reason, and confirm
using the legally required wording.
The customer receives a confirmation email and an on-screen receipt with a reference number. You
get a notification and a new entry in your admin.
From the admin you review the request, mark it **In progress**, **Completed**, or **Rejected**,
and issue any refund through Shopify as usual.
## Key terms
A few words you'll see throughout this documentation and inside the app:
| Term | What it means |
| ----------------------- | ---------------------------------------------------------------------------------------------- |
| **Right of withdrawal** | The EU customer's legal right to cancel an online order within the cooling-off period. |
| **Withdrawal window** | The time period a customer has to cancel. Defaults to **14 days** from delivery. |
| **Declaration** | The customer's statement that they want to withdraw from the contract. |
| **Reference number** | A unique ID for each request, like `WD-2026-0001`. |
| **Compliance status** | The app's automatic tracking of the request (e.g. *Confirmed*, *Confirmation sent*). |
| **Processing status** | Your own tracking of where you are with the request (*In progress*, *Completed*, *Rejected*). |
| **Exempt order** | An order the law doesn't require withdrawal for (e.g. B2B, subscriptions, some digital goods). |
## Next steps
Get the withdrawal button live on your store in a few minutes.
# Quickstart
Source: https://docs.clevyre.com/eu-withdrawal-button/quickstart
Install the EU Withdrawal Button and make it visible on your storefront
## Overview
Getting started takes just a few minutes. You'll install the app, then turn on the withdrawal button
in your theme. There is only **one required setup step** after installation — the app guides you
through it.
## Step 1: Install from the Shopify App Store
Go to the [Shopify App Store](https://apps.shopify.com/) and search for **Clevyre EU Withdrawal
Button**.
Click **Add app** to install it on your store. This is the same process as any other Shopify app.
Shopify will ask you to approve the access the app needs (such as reading your orders and
customers, and adding a block to your theme). Review it and click **Install**.
After installing, you land on the app's home dashboard inside your Shopify admin.
## Step 2: Enable the withdrawal button in your theme
When you first open the app, the home dashboard shows a **Setup Guide** with one step:
*"Enable the withdrawal footer link in your theme."*
The button won't appear on your storefront until you complete this step.
On the home dashboard, click **Open theme editor** in the Setup Guide card. This opens Shopify's
theme editor with the **Clevyre EU Withdrawal Button** block ready to add.
Add the withdrawal button block to your theme (the footer is a good place). The block makes the
floating button appear on every storefront page.
Click **Save** in the top-right corner of the theme editor to apply the change.
Once the block is enabled, return to the app's home dashboard — it automatically detects that the
step is complete and marks the Setup Guide as done.
## Step 3: Confirm the button is live
Visit your storefront. You should see the floating **"Withdraw from contract"** button in the corner
you chose (the bottom-right by default). Clicking it opens the customer withdrawal page.
That's it — your store now offers a compliant withdrawal process. The defaults are EU-ready out of
the box (a 14-day withdrawal window and the legally required wording).
## Recommended next steps
Match the button to your brand and set who gets notified.
Walk through exactly what your shoppers see when they withdraw.
Learn how to review and process incoming requests.
Adjust the cooling-off period and delivery estimate.
# Button appearance
Source: https://docs.clevyre.com/eu-withdrawal-button/settings/button-appearance
Match the withdrawal button to your store's branding
## Overview
The **Withdrawal button** section of Settings controls how the floating button looks and where it
appears on your storefront. A few small changes can make it blend right in with your brand.
## Options
Where the button sits on the screen. Choose **Bottom right** (the default), **Bottom left**, or
**Bottom center**. Pick a corner that won't clash with other widgets like chat bubbles.
How large the button is: **Small**, **Medium**, or **Large**. Larger sizes are easier to spot;
smaller sizes are more subtle.
The button's fill colour. Defaults to black (`#1A1A1A`). Use the colour picker or type a hex code
to match your brand.
The colour of the button's label. Defaults to white (`#FFFFFF`). Make sure it contrasts well with
the background colour so the text stays readable.
The label shown on the button. Defaults to **"Withdraw from contract"**, automatically shown in
your customer's language. Enter your own text (up to 80 characters) to override it, or clear the
field to go back to the per-language defaults.
Use your store's primary or accent colour for the background, and double-check the text colour stays
readable against it.
## Languages
The default button text and the customer-facing withdrawal flow are translated into several major EU
languages — English, German, Dutch, French, Italian, and Spanish — and shown automatically based on
the customer's language. If you set your own custom button text, that exact text is used for everyone.
## Next steps
Control how long customers have to withdraw.
# Emails & notifications
Source: https://docs.clevyre.com/eu-withdrawal-button/settings/emails-and-notifications
Control confirmation emails and where withdrawal alerts go
## Overview
The app sends two kinds of email automatically: a **confirmation email** to the customer, and a
**notification email** to you. The **Email sender** and **Notifications** sections of Settings let you
control how these appear and where they're delivered.
## Who gets which email
Sent when a customer confirms a withdrawal. It contains their declaration, the items, a reference
number, and the timestamp. This email is the **durable legal record** of the withdrawal.
Sent at the same time so you know a new withdrawal has arrived and can start processing it.
## Email sender settings
These control how the confirmation email appears to your customers:
The name customers see as the sender. Defaults to your shop's name. Up to 255 characters.
The address that receives replies if a customer responds to the confirmation email. Defaults to
the shop owner's email.
## Notification settings
The address where withdrawal alerts are sent. We recommend setting this to whoever handles
customer service or refunds. If you leave it blank, alerts fall back to your **reply-to email**.
Send notifications to a shared inbox (like `support@yourstore.com`) so withdrawals aren't missed if
one person is away.
## If a confirmation email fails
Occasionally an email can't be delivered (for example, a mistyped address). When this happens:
* The customer still sees their on-screen receipt and can **print or save** it.
* The withdrawal's [compliance status](/eu-withdrawal-button/managing/withdrawal-detail#compliance-status)
shows **Confirmation email failed**.
* You can open the request and click **Resend confirmation email** to try again.
# Settings overview
Source: https://docs.clevyre.com/eu-withdrawal-button/settings/overview
Everything you can configure in the EU Withdrawal Button
## Overview
The **Settings** page is where you tailor the app to your store. The defaults are already EU-ready, so
you only need to visit this page if you want to change the button's look, adjust the cooling-off
period, or control how emails are sent.
Changes are saved using the save bar at the top of the page — make your edits, then click **Save**
(or **Discard** to undo).
## What you can configure
Set the button's position, size, colours, and text to match your store.
Adjust the cooling-off period and the delivery estimate used to calculate it.
Choose the email sender details and where withdrawal alerts are sent.
You don't have to change anything to be compliant. The defaults — a 14-day window and the legally
required wording — work out of the box.
# Withdrawal window
Source: https://docs.clevyre.com/eu-withdrawal-button/settings/withdrawal-window
Set the cooling-off period and how it's calculated
## Overview
The **Withdrawal window** section controls how long a customer has to cancel their order. The defaults
follow EU law, so most stores never need to change these.
## Options
The length of the cooling-off period — how many days after delivery a customer can still withdraw.
The default is **14 days**, which is the EU legal minimum. You can set any value between **7 and
60 days**.
EU law requires a minimum of 14 days. Lowering this below 14 may put your store out of compliance.
Increasing it (offering a longer window) is always allowed.
A fallback used only when Shopify doesn't have an exact delivery date for an order. The app adds
this number of days to the ship date to estimate when delivery happened, then counts the
withdrawal period from there. The default is **5 days**, and you can set **1 to 60 days**.
## How the window is calculated
The cooling-off period is always measured from **delivery**, not from the order date:
The withdrawal period is counted from that exact delivery date.
The app estimates delivery as the **ship date + your estimated delivery days**, then counts the
withdrawal period from that estimate.
If a customer tries to withdraw after the window has closed, they're told the period has ended and
can't complete the request.
Set the estimated delivery to roughly match how long shipping usually takes for your store. A
realistic estimate keeps the calculated window fair for orders without a delivery date.
# Introduction
Source: https://docs.clevyre.com/index
Welcome to web-accessibility documentation
## Overview
Clevyre builds Shopify apps that make your store easier to use and easier to keep compliant. Our
products help store visitors adjust their experience and exercise their rights — with simple setup and
sensible defaults.
## Explore by product
Add an accessibility widget to your storefront. Customize the colour, icon, position, and language.
Offer a compliant EU right-of-withdrawal process so customers can cancel orders the legal way.
## Get started
Get the Accessibility Widget on your Shopify store in minutes.
Add a compliant withdrawal button to your store in minutes.
**Need help?** Contact support or visit our documentation for more details.