Set Up and Manage Free Trials

A free trial is an optional, popular marketing tactic that lets users try paid features of your app for a limited period. After the trial, users are charged automatically and need to opt out if they don’t want to pay to continue using the paid features of your app.

Apps with stable, recurring fees that are billed monthly or yearly and use the Wix billing system can have free trials fully managed by Wix. This includes:

• Displaying a free trial’s availability at various touch points on the Wix App Market.
• Taking payment details when a user opts in for the free trial (this increases conversion).
• Notifying the user by email when a free trial is purchased, canceled, and about to end.
• Automatically charging the user when the free trial ends (users can immediately cancel the free trial at any point on their Wix subscriptions page).

Set up a Wix-managed free trial

The following sections explain how to set up a Wix-managed free trial, including how to:

• Activate and configure a free trial in your app’s dashboard.
• Detect a user's free trial activity, such as when they start a free trial.
• Set up UI states within your app to reflect the trial's availability and status.

Step 1 | Activate and configure a free trial

1. Go to the Pricing page in your app's dashboard.
2. Enable Free Trial.
3. Input the amount of days you want to offer the trial for (up to 30 days).
4. Click Save.

Step 2 | Detect a user’s free trial activity

When a user begins a free trial plan, Wix considers them as paying customers, and triggers Paid Plan Purchased.

To detect if a user is on a free trial, call Get App Instance (REST | SDK). Check the returned instance properties, and activate or deactivate your app's paid features accordingly.

• isFree: false if a user is on a paid plan or free trial.
• billing: Only appears if isFree is false. Contains a property freeTrialInfo with status and endDate (to check how many days are left in the trial).
• freeTrialAvailable: Indicates if a user is eligible for a free trial or not.

When the free trial ends, and the user's credit card is charged, you won't receive a notification. However, if the user cancels before their credit card is charged, Paid Plan Auto Renewal Canceled is triggered.

Step 3 | Set up UI states in your app

For users eligible for a free trial, prompt them to start the trial with a button. You can know if a user is eligible by checking the freeTrialAvailable property returned from Get App Instance (REST | SDK).

Since a free trial is considered an upgrade, your button should use the following link, which must open in a new tab:

If your app offers only a premium plan with a free trial, choose one of these approaches until the user upgrades:

• Fully lock the app: Block all functionality and prompt the user to upgrade.
• Partially lock the app: Keep settings accessible but disable core features.

Step 4 | Test your free trial flow

After you've activated a free trial as described in step 1:

1. Add a recurring pricing plan in your app's dashboard and save it.
2. Listen to relevant webhooks such as Paid Plan Purchased.
3. Install the app on your site and check the App Instance: isfree should be true.
4. Upgrade the app with free trial for the new recurring pricing plan you just created.
5. Check that you receive the Paid Plan Purchased webhook and the relevant fields in App Instance are updated.

Transition from a self-managed free trial to a Wix-managed free trial

When your new app version is published with a Wix-managed free trial any users that are currently enrolled in the self-managed free trial will be offered the new free trial as well. Your app can prompt users to move to the new free trial and end their current one.

Set up a self-managed free trial

When a free trial is activated in the App Dashboard, Wix displays a free trial’s availability in various places on the Wix App Market. However, it’s the app’s responsibility to:

• Manage the user experience.
• Notify users when a free trial is purchased, canceled, and about to end.
• Charge users when the free trial ends.

Step 1 | Activate a free trial in the App Dashboard

1. Go to the Pricing page in your app’s dashboard.
2. Enable Free Trial.
3. Input the amount of days you want to offer the trial for (up to 99 days).
4. Click Save.
5. Your app needs to be submitted, approved and published for changes to take place.

Step 2 | Set up UI states within your app

You need to set up the following ‘availability’ states within your app:

1. App is added, trial started. Usually the app has its features active during the trial days. You can also show a counter of how many days are left.
2. Trial ended after X days. The app should be locked or minimal.

See also

• Set up a freemium model
• About pricing plans and business models