> For the complete documentation index, see [llms.txt](https://trybee-try-before-you-buy.gitbook.io/trybee-try-before-you-buy-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://trybee-try-before-you-buy.gitbook.io/trybee-try-before-you-buy-docs/trybee-try-before-you-buy/how-to-configure-the-trial-period-in-trybee.md).

# How to configure the trial period in TryBee?

### Getting Started with TryBee: Enable Risk-Free Shopping in Minutes

**TryBee** empowers **Shopify merchants** to offer a structured **Try Before You Buy** experience, **reducing** purchase hesitation, **lowering** cart abandonment, and **increasing** conversion rates. By allowing customers to **test products** at home for **7–30 days** with a small upfront charge, you create **trust-driven buying** experiences while maintaining **full control** over **payments, inventory,** and **returns.**

**Ready** to **supercharge** your store?🤔 Follow this **quick setup** guide to launch **TryBee** in **minutes.**

### Setup Requirements

Before activating **TryBee,** ensure the following **prerequisites** are in place:

* An active **Shopify store** (any plan).
* **Store Owner** or **Admin access** (required for permissions and theme integration).
* [**TryBee**](https://apps.shopify.com/trybee-try-before-you-buy) installed via the **Shopify App Store**.\ <br>

  <figure><img src="/files/86OVuB10GpCKUKSjmMui" alt=""><figcaption></figcaption></figure>
* A configured **payment gateway** (e.g., Shopify Payments or Stripe) to securely process deposits and post-trial charges.

### Step-by-Step Onboarding Guide

Once installed, the **TryBee** dashboard presents a **guided onboarding** flow. Each step builds the **operational foundation** of your **trial program.**

<figure><img src="/files/1VDeCHFFLIEE97Oer3Hy" alt=""><figcaption></figcaption></figure>

### Step 1: Configuring Your Try Before You Buy Plan

When you click **Setup Plan**, you are redirected to the **Try Before You Buy Plan page.**

<figure><img src="/files/GMdiFnNC25yuD4LI5lPv" alt=""><figcaption></figcaption></figure>

It is where you define the **operational structure** of your **trial program**, including **trial timelines**, **authorization limits**, **product eligibility**, and **customer purchase rules.**

<figure><img src="/files/JkS4td0qHI89itoVbOFj" alt=""><figcaption></figcaption></figure>

Each section below determines how your **Try Before You Buy** experience **functions** for **customers** and how **payments** are authorized and captured.

1. #### Trial Settings:&#x20;

Configure the **trial periods** and **authorization timeline**

This section defines the complete lifecycle of a **trial order**,  from **order creation** to **final payment capture** or **return completion.**

* **Pre-Trial Period**

(From order creation to trial beginning)

The **Pre-Trial Period** acts as a **buffer** between **order placement** and the start of the **customer’s trial.**

* This **duration** typically accounts for **shipping** and **delivery time.**
* The **trial clock** begins once **delivery** is **confirmed.**
* If **delivery confirmation** is not detected, the trial will **automatically** begin after the defined **pre-trial duration.**
* **Trial Period**

This is the core **“try at home”** duration.

* Defines **how many days customers** can **test** the product.
* During this period, only the **checkout fee** is **charged.**
* If the customer does not **initiate a return** before the **trial ends**, the **remaining** balance is **automatically captured.**
* **Return Period**

The Return Period begins after the **trial period ends**.

* Specifies the **maximum number** of days **allowed** to complete the **return process.**
* This gives customers a **structured grace window.**
* If the return period is **disabled** (checkbox selected), customers must **return items** within the **trial window** only.

Important:\
The total authorization duration =\
**Pre-Trial Period + Trial Period + Return Period**

This total determines how long **payment authorization** remains valid before **final charge or release**.

* **Total Authorization Period**

**Displayed automatically** at the bottom of the section.

This is the combined duration of all **configured timelines.** It ensures your payment gateway maintains **authorization coverage** for the entire trial lifecycle.

<figure><img src="/files/upi0FymUinNBkbx0vusk" alt=""><figcaption></figcaption></figure>

2. ### Try Before You Buy Rules:&#x20;

This section controls **purchase limits** and **prevents misuse.**

**Maximum Products Per Order**

Defines how many **trial-eligible products** a customer can include in a **single order.**

* The limit is displayed to customers in the **Try Before You Buy popup.**
* The restriction is **enforced** during **checkout.**

<figure><img src="/files/ZRAk8RKi9E806CZcA83d" alt=""><figcaption></figcaption></figure>

3. ### Pay Just X Now:

Configure the **upfront checkout charge**

This section determines what customers **pay at checkout** when selecting **Try Before You Buy.**

You can choose between:

* **Percentage (%)**
* **Fixed Amount ($)**

**Checkout Charge Amount**

Set the amount customers must **pay at** **checkout.**

Example:

* 20% of product price Or $5 fixed charge

This amount is:

* Charged immediately at **checkout**
* **Refunded** if the product is returned
* **Deducted** from the total if the customer keeps the item

How it works:

* The **customer pays** the defined portion **upfront.**
* If they keep the **product → remaining balance** is automatically charged at the **end of the trial.**
* If they **return the product** → only the defined **fee rules apply** (based on your configuration).

**Strategic consideration:**\
A small upfront fee **reduces fraudulent orders** while keeping entry friction low.

<figure><img src="/files/9YHMMjBsXJBgNFifrHRS" alt=""><figcaption></figcaption></figure>

## 4. Selected Items

Choose which products are **eligible** for **Try Before You Buy**

This section determines **product eligibility.**

You have two options:

* ### Include All Products

**Enables** **Try Before You Buy** for your entire catalog.

* Every product becomes **trial-eligible.**
* Ideal for stores fully committed to **trial-based selling.**

<figure><img src="/files/1ZnWl7kdRqNtTQT5UF4y" alt=""><figcaption></figcaption></figure>

* ### Include Specific Products

Allows selective activation.

* Only **chosen products** will display the Try Before You Buy option.
* Useful for testing the feature with **specific categories** or **high-margin products.**
* Helps **reduce inventory risk** during **initial rollout.**

<figure><img src="/files/0WPsV8Gzk3NvpLcc0fVF" alt=""><figcaption></figcaption></figure>

<mark style="color:$danger;background-color:yellow;">**Note:**</mark>  <mark style="color:yellow;background-color:yellow;">If you experience an error while selecting</mark> <mark style="color:yellow;background-color:yellow;"></mark><mark style="color:yellow;background-color:yellow;">**Specific Products,**</mark> <mark style="color:yellow;background-color:yellow;"></mark><mark style="color:yellow;background-color:yellow;">scroll to the top of the</mark> <mark style="color:yellow;background-color:yellow;"></mark><mark style="color:yellow;background-color:yellow;">**Try Before You Buy Plan**</mark> <mark style="color:yellow;background-color:yellow;"></mark><mark style="color:yellow;background-color:yellow;">page and click</mark> <mark style="color:yellow;background-color:yellow;"></mark><mark style="color:yellow;background-color:yellow;">**Cancel Subscription**</mark><mark style="color:yellow;background-color:yellow;">. After confirming the cancellation,</mark> <mark style="color:yellow;background-color:yellow;"></mark><mark style="color:yellow;background-color:yellow;">**recreate a new campaign**</mark> <mark style="color:yellow;background-color:yellow;"></mark><mark style="color:yellow;background-color:yellow;">and configure the product selection again. This typically resolves</mark> <mark style="color:yellow;background-color:yellow;"></mark><mark style="color:yellow;background-color:yellow;">**temporary configuration conflicts.**</mark>

After completing these steps, click on **Save**. Once **saved**, your **Try Before You Buy** structure becomes active and immediately applies to selected products.

### Step 2: Select Products Eligible for Trials

Defining **product** **eligibility** allows you to control **inventory exposure**, monitor performance, and strategically introduce the Try Before You Buy model before expanding across your full catalog.

If **product eligibility** was already configured in a **previous step,** you may skip this section and simply click **Mark as Done**. Otherwise, follow the steps below to proceed.

#### Configuration Instructions:&#x20;

1. Click **Select Products** to access the eligibility settings.
2. Choose how you would like to **apply the trial feature**:
3. **All Products**: **Enables Try Before You Buy** across your entire store catalog.
4. **Specific Products or Collections:** Limits eligibility to selected items or collections, allowing for **controlled rollout** (e.g., apparel, beauty, premium products).
5. **Review** your selected items to confirm **accuracy.**\ <br>

   <figure><img src="/files/Ir48OcMRFmQ97pQJsUR7" alt=""><figcaption></figcaption></figure>
6. Click **Save** Settings to apply changes instantly.

A phased or category-based rollout enables you to evaluate **operational efficiency**, **monitor customer behavior,** and optimize the **trial structure** before scaling store-wide.

### Step 3: Activate the “Try Before You Buy” Button

<mark style="color:$danger;background-color:yellow;">**Note:**</mark> <mark style="color:yellow;background-color:yellow;">This step is</mark> <mark style="color:yellow;background-color:yellow;"></mark><mark style="color:yellow;background-color:yellow;">**optional**</mark><mark style="color:yellow;background-color:yellow;">. If the</mark> <mark style="color:yellow;background-color:yellow;"></mark><mark style="color:yellow;background-color:yellow;">**widget/block**</mark> <mark style="color:yellow;background-color:yellow;"></mark><mark style="color:yellow;background-color:yellow;">is</mark> <mark style="color:yellow;background-color:yellow;"></mark><mark style="color:yellow;background-color:yellow;">**not visible**</mark> <mark style="color:yellow;background-color:yellow;"></mark><mark style="color:yellow;background-color:yellow;">on your storefront, complete the</mark> <mark style="color:yellow;background-color:yellow;"></mark><mark style="color:yellow;background-color:yellow;">**following steps**</mark> <mark style="color:yellow;background-color:yellow;"></mark><mark style="color:yellow;background-color:yellow;">to properly display it on the frontend.</mark>

This step **enables** the **customer-facing trial** option on **eligible product pages,** making the Try Before You Buy program **visible** and **accessible to shoppers**.

#### Activation Instructions

1. From the **TryBee dashboard**, click **Activate Extension**.

<figure><img src="/files/xYkDWGdNhctenHVAzF0K" alt=""><figcaption></figcaption></figure>

2. You will be redirected to your **Shopify Theme Embed** settings.
3. Locate **TryBee** in the list of available app embeds.
4. Ensure the **toggle** is **switched ON.**
5. Click **Save** to apply the changes.

Once **saved**, the **Try Before You Buy button** will **appear** on all **eligible product pages.**

<figure><img src="/files/DX436I75t3c9MqVIs7OE" alt=""><figcaption></figcaption></figure>

Activating the **extension** ensures customers can clearly see and select the **Try Before You Buy** option while **browsing your products**.

### Step 4: Add the Product Page Block

Ensures prominent **placement** of the **trial button**, especially on custom or heavily modified themes.

**Steps:**

1. From the TryBee dashboard, click on **Add Block.**&#x20;

<figure><img src="/files/T6dfSigZorkf8MUU6gfn" alt=""><figcaption></figcaption></figure>

1. It will redirect you to the **Default Product Page.**

<figure><img src="/files/VR3fPFu2RNf1o8cg7bPh" alt=""><figcaption></figcaption></figure>

3. Click **Add Block → Try Before You Buy.**
4. Position it above or below the **Add to Cart button**.
5. **Save** your changes.

<figure><img src="/files/kVPc6Ssf6VsITPW5EybK" alt=""><figcaption></figcaption></figure>

Strategic placement **increases visibility** and improves **trial engagement.**

### Step 5: Add the Customer Account Block

Adding the **Customer Account Block** gives shoppers **clear visibility** into their **active trials**. From their account area, customers can review trial status, track payments, and manage return requests, reducing support inquiries while **improving transparency** and trust.

#### Activation Instructions

1. From the **TryBee Dashboard**, click **Add Customer Account Block.**

<figure><img src="/files/GSEzl1xOC4zXKZqNvVkJ" alt=""><figcaption></figcaption></figure>

2. You will be redirected to the **Order Status / Customer Account** customization page in Shopify.
3. Under the Apps section, locate **TryBee**: **Try Before You Buy.**

You will see two available blocks:

* TryBee: **Order Status**
* TryBee: **Customer Portal**

<figure><img src="/files/h7SZWThQ3Zgl8B6B10R3" alt=""><figcaption></figcaption></figure>

4. Click the **“+”** icon next to **each block** to add them to the layout.

<figure><img src="/files/LsCqomxm9i5iLmSeUuIR" alt=""><figcaption></figcaption></figure>

5\. Click on **add to** **order status** to add **TryBee Order Status** and then **Save** it.&#x20;

<figure><img src="/files/8hA3s7LYu8JVPArXdMpE" alt=""><figcaption></figcaption></figure>

6\. Click on **Accounts** to add the **TryBee Customer Portal page** and then click on **Save**.&#x20;

<figure><img src="/files/HWLwRYM9w2bbcqMOIJLJ" alt=""><figcaption></figcaption></figure>

5. **Position** them appropriately within the page structure.

#### Optional: Add TryBee to the Customer Account Menu

To improve accessibility:

1. Select the **Customer Portal block**.
2. Click **Add to Menu.**\ <br>

   <figure><img src="/files/P4B8VYTnEYQD7mkid3Qe" alt=""><figcaption></figcaption></figure>
3. **Save** your changes.\ <br>

   <figure><img src="/files/bRGFj5hMi4Tnm7bEkhgO" alt=""><figcaption></figcaption></figure>

This ensures customers can directly access the **TryBee portal** from their account **navigation menu.**

Once enabled, customers will be able to:

* **View active** and **completed trials**
* Monitor **payment timelines**
* **Initiate** or **track returns**
* **Manage** their **Try Before You Buy orders** independently

Properly configuring this section strengthens the post-purchase experience and supports a self-service workflow for trial management.

### Final Verification

Before going live:

1. Open an **eligible product page** and confirm the **trial button** is **visible.**
2. Simulate checkout to **validate fee logic.**
3. Check the TryBee dashboard to confirm test trial data appears correctly.

Once **verified**, your program is **fully operational.**

<figure><img src="/files/devZ4bJ9AilvrXwEAcV2" alt=""><figcaption></figcaption></figure>

### You’re Ready to Launch

With **TryBee configured,** your store can now offer structured home **trials** that convert **cautious browsers** into confident buyers. Monitor early performance in the dashboard and refine **product eligibility** or **fee structures** as needed.

If you **need assistance**, you can contact our **support team** directly through the **in-app chat** within the dashboard or [**schedule a call**](https://calendly.com/talk-to-specialist/30min) with one of our **experts** for **personalized guidance.**

<br>


---

# 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://trybee-try-before-you-buy.gitbook.io/trybee-try-before-you-buy-docs/trybee-try-before-you-buy/how-to-configure-the-trial-period-in-trybee.md?ask=<question>
```

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.