1. Home
  2. Documentation
  3. WordPress SDK
  4. Testing


Before you release a version of your product that has Freemius integrated into it into production – you probably want to test things out, and make sure everything works properly, so there are no surprises later on.

Here’s what Freemius recommends in terms of testing the functionality & integration:

Setting Freemius Into Development Mode

Add the following constants to your testing environment’s wp-config.php file while replacing my-slug in WP_FS__my-slug_SECRET_KEY with your plugin’s or theme’s unique lowercase slug:

/* Set Freemius into development mode */
define( 'WP_FS__DEV_MODE', true );
 * Set your plugin / theme Freemius secret key for super powers!
 *   1. Replace `my-slug` with your product's lowercase slug.
 *   2. Replace `sk_mySecretKey` with your product's secret key.
define( 'WP_FS__my-slug_SECRET_KEY', 'sk_mySecretKey' );

You should add the defines before the WordPress Engine starts, i.e. before /* That is all, stop editing! Happy blogging. */.

When you refresh the WP Admin, you should notice a new top level menu item:

If you click you’ll be able to see all the Freemius data associated with your local environment.

In addition, the WP_FS__DEV_MODE will turn on logging. You can see the logs by inspecting the browser’s developers console:

Or if you are using Debug Bar, Freemius is fully integrated with it:

Testing User Opt-in

For apparent reasons – the opt-in screen appears only once (upon activation). After opting-in (or skipping) the screen will not show again.

To make it appear again after an opt-in you’ll need to delete the installation from Freemius. You can do that by clicking the Account submenu item:

Or if your Account menu item isn’t available, go to /wp-admin/admin.php?page=my-slug-account.

There, click on the Delete Account link which will reload the opt-in page:

To make it appear after skipping, clear Freemius data by opening Freemius Debug in the admin dashboard, and delete the accounts (for more info on Freemius debug please see our debugging guide).

Skipping Email Activation

Due to security and data integrity reasons, if an already opted-in user attempts to opt-in to Freemius again, you will first receive an activation email so you may complete the process.
This helps prevent users from hijacking other user accounts.
The caveat for that is that this step might slow down the development & testing process. To skip it, simply add the following constant to your testing environment’s wp-config.php file in addition to the previously added constants:

/* Skip email activation when a user with the same email already opted-in */
define( 'WP_FS__SKIP_EMAIL_ACTIVATION', true );

Sandbox Payments

Freemius provides an option for you to sandbox test payment for your products, in order for you to be able to experience your product’s checkout process, as well as make sure that everything works as it should. Here’s how to use it:

To set Freemius into sandbox payments mode make sure your wp-config.php file contains the following constant with your secret key:

 * Set your plugin / theme Freemius secret key for super powers!
 *   1. Replace `my-slug` with your product's lowercase slug.
 *   2. Replace `sk_mySecretKey` with your product's secret key.
define( 'WP_FS__my-slug_SECRET_KEY', 'sk_mySecretKey' ); 

Testing credit cards

Card Number Card Type
4242424242424242 Visa
4000056655665556 Visa (debit)
5555555555554444 MasterCard
5200828282828210 MasterCard (debit)
5105105105105100 MasterCard (prepaid)
378282246310005 American Express
6011111111111117 Discover
30569309025904 Diners Club
3530111333300000 JCB

Testing PayPal accounts

Type Email Password Country Verified Credit Card
Personal [email protected] freemius US true Visa
Business [email protected] freemius US true Visa

You can login with the above credentials into a PayPal Sandbox to see the account activity.