Discounts and trial extensions

After monetizing your app, you can focus on increasing app purchases, attracting new users, and converting free users to paid plans. We offer a handful of tools and mechanisms to help you promote your app or make it more discoverable in the marketplace (read more here), but if your app is monetized by monday, you can also use discounts and trial extensions to help you reach your goals!

This guide will cover who is eligible for discounts and trial extensions, how to create them, and common error messages you may receive. You can also check out our pricing report to learn more about leveraging discounts to attract and retain users!

Discounts

After first thought, offering a discounted rate may seem counterintuitive. If you want to generate more profit, why would you provide discounts to app users? Contrary to popular belief, discounts can be strategically leveraged at select decision-making points—like upgrades, conversions, churns, or trial ends—to keep or attract users.

For example, you could offer a discount to a user nearing the end of a trial. The discount may help increase the odds of converting them into paid users. You could also directly reach out to the user to offer a limited-time discount if they decide to purchase a paid plan.

In the same way, you can offer a discount to users on your app's free plan (if it has one). The discounted rate may encourage them to convert from the free to the lowest-paid plan. You can contact them using their email and offer an ad-hoc discount. You can also offer users a discount to transition them from their current plan to a higher one. Let's say that a paid user is reaching the limits of their plan. They generate 490 PDFs monthly, but their plan limits them to 500. You can contact them directly to offer a discount if they upgrade to a higher tier.

Eligible customers

You can only offer discounts to users pre-purchasing the plan (i.e., those creating a new plan subscription). Users do not need to have the app installed on their account for you to grant a discount.

If a customer has already purchased a plan, you can't provide a discount for the same tier. However, you can give a discount for a new plan if an account already has an active plan and wants to switch to a different tier.

How to create a discount

Developer Center

  1. In the Developer Center, click Monetization > Discounts.
  2. Click Grant a new discount.
  3. Enter the Account slug. You can obtain the account slug from your webhooks or by querying the account through the API. If you want to apply the discount to all accounts, enter -1.
  4. Select the plan(s) for which you want to offer a discount.
  5. Specify if the discount is for a monthly or yearly plan.
  6. Designate whether or not you want the discount to reoccur.
  7. Type in the discount percentage you would like to offer.
  8. Enter the number of days the discount is valid for.
  9. Click Set. After you offer the discount, the user can view the plan options in the app. They must select the plan for which you provided a discount, and the reduced rate will appear.

API

You can also grant discounts using the API with the grant_marketplace_app_discount mutation:

mutation {
  grant_marketplace_app_discount (
      account_slug: "Test",  
      app_id: 123456,
    	data: {
    		app_plan_ids: ["Basic"],
      	days_valid: 30, 
      	discount: 10, 
      	is_recurring: false, 
      	period: MONTHLY
    }) {
    granted_discount {
        app_id
      	period
      	discount
    }
  }
}

How to delete a discount

Developer Center

  1. In the Developer Center, click Monetization > Discounts.
  2. Click the trash can next to the discount you want to delete.
  3. Select Confirm.

API

You can also delete discounts using the API with the delete_marketplace_app_discount mutation:

mutation {
  delete_marketplace_app_discount (
    account_slug: "Test", 
    app_id: 123456
  ) {
    deleted_discount {
      account_slug
      app_id
    }
  }
}

Error messages

You may receive an error message when attempting to grant a discount to an account for various reasons. Check out the table below to learn about each error message and why you received it.

Error messageIssue
Failed to grant discount - Check your inputsUser entered invalid input (e.g. a negative discount percentage)
Failed to grant discount - Invalid account detailsAccount with the provided account ID doesn't exist
Failed to grant discount - App isn't installed on the accountThe app is not installed on the account
Failed to grant discount - User cannot grant discountsGranting user cannot provide discounts

Trial extensions

Trial periods, in general, offer users the chance to learn about your app and use all its features risk-free. They get the same benefits as paid users for a limited time and may be more likely to purchase a plan once the trial period ends. Each app can only offer trial periods of 14 days, but those monetized through monday can offer trial extensions for users!

Extending a trial period can be a helpful tactic for converting users to paid plans. For example, you could offer select users trial extensions as they near the end of their trial period based on their usage and potential to convert and communicate this to them via email.

Extended trials give users more time to familiarize themselves with the app without risking their money upfront. Once the user is more comfortable with the app and its features, they're more likely to pay for a plan once the trial ends. Users will receive a notification on the monday platform when their trial period (initial or extended period) is over that prompts them to pick a new plan.

1430

Eligible customers

Users must have the app installed on their account for you to be able to extend their trial.

You can only extend trials for users currently in a trial period or those whose trial ended but did not create a new subscription. Once the trial extension is granted, it overrides their existing trial period. For example, if they have five days left and you extend their trial for ten days, the trial will only be valid for ten days.

How to extend a trial

Developer center

You can follow these steps to provide an account(s) with a trial extension using the developer center:

  1. In the Developer Center, click Monetization > Trials.

  2. Enter the Account slug. You can obtain the account slug from your webhooks or by querying the account through the API.

  3. Select the plan for which you want to extend the trial.

  4. Specify how long the extension should last. The maximum allowed period is 365 days.

  5. Click Set.

API

You can also provide trial extensions for up to 5 accounts using the API with the batch_extend_trial_period mutation:

mutation {
  batch_extend_trial_period (account_slugs: ["test", "monday"], app_id: 12345678, plan_id: "Plan_1", duration_in_days: 21) {
    details {
      account_slug
      reason
      success
    }
    reason
    success
  }
}

Error messages

You may receive an error message when attempting to extend an account's trial period for various reasons. Check out the table below to learn about each error message and why you received it.

Error messageIssue
Failed to extend trial - Check your inputsUser entered invalid input (e.g. 999 days)
Failed to extend trial - Invalid account detailsAccount with the provided account ID doesn't exist
Failed to extend trial - Account missing monetized install of applicationThe app is not installed on the account
Failed to extend trial - Existing app subscriptionAccount already purchased a subscription
Failed to extend trial - User cannot extend trialsGranting user can't provide trial extensions

📘

Join our developer community!

We've created a community specifically for our devs where you can search through previous topics to find solutions, ask new questions, hear about new features and updates, and learn tips and tricks from other devs. Come join in on the fun! 😎