# Offering Free Trials

The Freemius WordPress SDK allows you to seamlessly offer free trials for your freemium WordPress plugins and themes. This enables potential customers to experience your premium features before making a purchase.

This is how the built-in pricing page looks when a trial is available for a product plan.

![Freemius WordPress SDK - Trials integration](/help/assets/ideal-img/freemius-wordpress-sdk-trial-pricing-page.271f7da.480.png)

## Enable Free Trials in a Plan[​](#enable-free-trials-in-a-plan "Direct link to Enable Free Trials in a Plan")

1. For each plan, scroll to the **Trial** section.
2. Specify the duration of the trial period (e.g., 7 days, 14 days). This setting is saved automatically when you select the duration.
3. Choose whether to require a payment method or not.

![Freemius Dashboard - Activating the trials option in a plan's settings](/help/assets/ideal-img/activating-trial-option-freemius-plan.984a734.480.png)

note

Check out [this guide](https://freemius.com/help/help/documentation/selling-with-freemius/set-up-trials/.md) for more information on Trials usage.

## Integrating Trials in the Product[​](#integrating-trials-in-the-product "Direct link to Integrating Trials in the Product")

note

If you haven't yet integrated the Freemius WordPress SDK into your product, get started [here](https://freemius.com/help/help/documentation/wordpress/integration-with-sdk/.md).

If you are using the [licensing methods](https://freemius.com/help/help/documentation/wordpress-sdk/integration/software-licensing/.md) `is_plan()` or `is_plan__premium_only()` in your integration with the WP SDK, then transition to the `is_plan_or_trial()` and `is_plan_or_trial__premium_only()` methods accordingly.

Finally, you need to update the SDK integration snippet in your product to enable trial support. This is done by adding a `trial` array to the integration snippet, as follows:

```
  'trial' => array(

      'days'               => 14,

      'is_require_payment' => false,

  ),
```

The exact code will differ based on your product's configuration. The best way to get the correct code snippet is to copy it from the [Freemius Developer Dashboard](https://freemius.com/help/help/documentation/wordpress/integration-with-sdk/.md#insert-the-auto-generated-sdk-integration-snippet).

Now the SDK will automatically handle trial related logic and UI.

### Trial Admin Notice[​](#trial-admin-notice "Direct link to Trial Admin Notice")

For a freemium product integrated with the Freemius WordPress SDK, a dismissible admin notice with a trial offer will automatically appear in the WP admin dashboard **24 hours after installing the free product (plugin/theme) version**.

![Freemius WP SDK - Free trial alert](/help/assets/ideal-img/free-trial-alert.7b208b9.480.png)

In addition to the admin notice, the Upgrade submenu item changes its label to **Start Trial**, and its color matches the blue of the promotional admin notice:

![Freemius WP SDK - Start trial submenu item](/help/assets/ideal-img/start-trial-submenu-item.c39e4bb.480.png)

Clicking the **Start Trial** button redirects the user to the product's in-dashboard pricing page with the option to start a trial for any of the plans.

Once the user selects a plan and starts the trial, the premium version becomes securely accessible through a download link that appears in an admin notice and in an automated customer email.

Customization

You can customize the [trial notice visibility](#customizing-the-free-trial-notice) and the [trial display time](#customizing-the-free-trial-offer-timing).

![Freemius WP SDK - Showing trial download link in the WordPress Admin](/help/assets/ideal-img/trial-activation-download-link.836f0cd.480.png)

### Product Admin Menu Item[​](#product-admin-menu-item "Direct link to Product Admin Menu Item")

If you have a top-level menu item, the SDK will automatically add a counter to attract additional attention:

![Freemius WP SDK - Start trial top level menu item](/help/assets/ideal-img/trial-notification-on-top-level-menu-item.429da28.480.png)

### Custom Trial Upgrade Links[​](#custom-trial-upgrade-links "Direct link to Custom Trial Upgrade Links")

Since the Freemius WordPress SDK automatically handles the trial offer display and logic, you can easily add links to the trial page in your free product version. You might want to add such links in various locations, such as under the plugins menu or in your plugin's settings page.

![Freemius WP SDK - Custom Trial usage link under the plugins menu](/help/assets/ideal-img/freemius-wordpress-sdk-trial-usage-link.15df4fd.480.png)

The SDK includes a built-in method to provide the trial upgrade link, which you can wrap in your HTML anchor tags.

```
 // Make sure to change my_fs() to your Freemius instance name.

 my_fs()->get_trial_url();
```

## Customizations[​](#customizations "Direct link to Customizations")

### Override the default upgrade link[​](#override-the-default-upgrade-link "Direct link to Override the default upgrade link")

Using the [pricing\_url filter](https://freemius.com/help/help/documentation/wordpress-sdk/customization/filters-actions-hooks/.md#pricing_url) provided by the WordPress SDK leading to an checkout page, custom admin page or your website where you have added the [checkout buttons with trial functionality](https://freemius.com/help/help/documentation/selling-with-freemius/set-up-trials/.md#share-trial-links-with-customers).

### Customizing the Free Trial Notice[​](#customizing-the-free-trial-notice "Direct link to Customizing the Free Trial Notice")

The free trial promotional offer includes default text and descriptions.

![Freemius WP SDK - Free trial alert](/help/assets/ideal-img/free-trial-alert.7b208b9.480.png)

These strings are customizable using the following filters:

```
 <?php

 my_fs()->override_i18n( array(

    'hey' => 'Hey',

    'trial-x-promotion-message' => 'Thank you so much for using %s!',

    'already-opted-in-to-product-usage-tracking' => 'How do you like %s so far? Test all our %s premium features with a %d-day free trial.',

    'start-free-trial' => 'Start free trial',

    // Trial with a payment method required.

    'no-commitment-for-x-days' => 'No commitment for %s days - cancel anytime!',

    // Trial without a payment method.

    'no-cc-required' => 'No credit card required',

) );
```

tip

You can control the visibility of admin notices added by the Freemius SDK using this [`show_admin_notice`](https://freemius.com/help/help/documentation/wordpress-sdk/customization/filters-actions-hooks/.md#show_admin_notice) filter hook.

### Customizing the Free Trial Offer Timing[​](#customizing-the-free-trial-offer-timing "Direct link to Customizing the Free Trial Offer Timing")

#### Initial Display Timing[​](#initial-display-timing "Direct link to Initial Display Timing")

Instead of the notice appearing the default 24 hours after installation, you can control when it appears using the following filter:

```
// Show the 1st trial promotion after 7 days instead of 24 hours.

function my_show_first_trial_after_7_days( $day_in_sec ) {

    // 7 days in sec.

    return 7 * 24 * 60 * 60;

}



my_fs()->add_filter( 'show_first_trial_after_n_sec', 'my_show_first_trial_after_7_days' );
```

#### Resurfacing the Free Trial Offer[​](#resurfacing-the-free-trial-offer "Direct link to Resurfacing the Free Trial Offer")

Customers who have dismissed the free trial offer admin notice can be shown the offer again after a certain period. By default, this period is set to 30 days. You can customize this period using the following filter:

```
function my_reshow_trial_after_every_60_days( $thirty_days_in_sec ) {

    // 60 days in sec.

    return 60 * 24 * 60 * 60;

}



my_fs()->add_filter( 'reshow_trial_after_every_n_sec', 'my_reshow_trial_after_every_60_days' );
```