> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kwebby.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Trade-in estimator

> A three-step estimator: shoppers pick a device type, its age and its condition and see a store credit range worked out from your own values. Nothing is sent anywhere.

![Trade-in estimator on the storefront](https://mintcdn.com/kwebby/MS8e7xtq5qj3x24S/images/kelvin/trade-in.webp?fit=max\&auto=format\&n=MS8e7xtq5qj3x24S\&q=85\&s=485b031d4e5904483f6eb8c665f9f80e)

Trade-in estimator, highlighted with the demo content

## Where to find it

The care template (page.care), at the bottom. Create a page in **Online Store → Pages** with **Theme template** care, then in the theme editor choose **Pages**, then **care**, and select **Trade-in estimator**. Add it to other templates with **Add section**.

## How it works

* Shoppers choose 1 Device type (one tile per Device block), 2 Age and 3 Condition. Until all three are chosen, the result card says how many are chosen and what is left.
* The range is the device's Lowest value and Highest value, times the age share, times the condition share, rounded to Round to the nearest. The card shows that working line by line, with Paid as.
* When the lowest value rounds to zero the result reads Up to and the highest value. When even the highest is below the rounding step, it reads No credit with Text when there is no credit.
* The two buttons show only when there is a credit range. Start over clears the choices.
* Nothing is sent or saved: the estimate stays on the shopper's screen and creates no order or store credit.
* Show the table of values adds a How we price trade-ins panel listing the like-new credit for every device and age, with the condition shares. It works without JavaScript; Open the table of values opens it on load.
* Under 1180 px the result card sits under the choices and scrolls into view once the third choice is made, without smooth scrolling when reduced motion is on.

![Trade-in estimator in the theme editor](https://mintcdn.com/kwebby/QKNMzt7KPy_yk6ai/images/kelvin/editor-trade-in.webp?fit=max\&auto=format\&n=QKNMzt7KPy_yk6ai\&q=85\&s=8185b3306465d964bced6ee2caea1890)

In the theme editor: 1 the section in the sidebar · 2 its settings · 3 the section in the preview

## Edit it

* Add a Device block per type (up to 12) with Device type, Examples, and Lowest value and Highest value for a like-new device under a year old, in your store's currency.
* Set the four ages and conditions: First age with First age share, First condition with First condition note and First condition share, and so on. Leave a label blank to hide that choice.
* Set Round to the nearest, such as 5.
* Edit Result label, Paid as, Text when there is no credit and Fine print to match how you really handle trade-ins.
* Fill in First button label and First button link (such as /pages/stores) and the second button (such as /pages/contact?topic=returns); a button without a link does not show.

## Settings

| Setting | What it does |
| - | - |
| **Color scheme** | Color scheme for this area (edit the schemes in Theme settings → Colors). Default: Scheme 1. |
| **Link id** | Text. Lets a link such as #trade-in jump to this section. Letters, numbers and hyphens. Default: trade-in. |
| **Heading** | Text. Default: Trade-in estimator. |
| **Text** | Formatted text. |

**Values**

| Setting | What it does |
| - | - |
| **Round to the nearest** | Number. In your store's currency. Default: 5. |
| **First age** | Text. Default: Under 1 year. |
| **First age share** | Slider from 0 to 100 %. Default: 100 %. |
| **Second age** | Text. Default: 1 to 2 years. |
| **Second age share** | Slider from 0 to 100 %. Default: 68 %. |
| **Third age** | Text. Default: 2 to 4 years. |
| **Third age share** | Slider from 0 to 100 %. Default: 40 %. |
| **Fourth age** | Text. Leave a label blank to hide that choice. Default: Over 4 years. |
| **Fourth age share** | Slider from 0 to 100 %. Default: 12 %. |
| **First condition** | Text. Default: Like new. |
| **First condition note** | Text. Default: No marks, works perfectly, with its cable or charger. |
| **First condition share** | Slider from 0 to 100 %. Default: 100 %. |
| **Second condition** | Text. Default: Good. |
| **Second condition note** | Text. Default: Light wear from normal use, everything works. |
| **Second condition share** | Slider from 0 to 100 %. Default: 80 %. |
| **Third condition** | Text. Default: Fair. |
| **Third condition note** | Text. Default: Visible scratches or dents, everything still works. |
| **Third condition share** | Slider from 0 to 100 %. Default: 55 %. |
| **Fourth condition** | Text. Default: Faulty. |
| **Fourth condition note** | Text. Default: Does not power on, a cracked screen or a failed part. |
| **Fourth condition share** | Slider from 0 to 100 %. Default: 15 %. |

**Result**

| Setting | What it does |
| - | - |
| **Result label** | Text. Default: Estimated store credit. |
| **Paid as** | Text. Default: Store credit within 5 days. |
| **Text when there is no credit** | Text. Default: We still take it: recycling is free, and drives are wiped first. |
| **Fine print** | Formatted text. |
| **First button label** | Text. Default: Trade in at a store. |
| **First button link** | Link: a page, product, collection or web address. |
| **Second button label** | Text. Default: Ask for a mail-in label. |
| **Second button link** | Link: a page, product, collection or web address. |
| **Show the table of values** | On or off. Default: on. |
| **Open the table of values** | On or off. Default: off. |

## Blocks

Add a block with **Add block** under the section in the sidebar; drag blocks to reorder them.

### Device (up to 12)

| Setting | What it does |
| - | - |
| **Device type** | Text. Default: Headphones. |
| **Examples** | Text. Default: Over-ear, on-ear and earbuds. |
| **Lowest value** | Number. Like new and under a year old, in your store's currency. Default: 90. |
| **Highest value** | Number. Default: 140. |

> [!NOTE]
>
> The device values on install are examples. Set your own before you publish the page.
>
> This is an estimate only. Inspect the device and issue the credit yourself, for example as a gift card.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.