1. Documentation
  2. Expirations
  3. Add expiration to an element

Add expiration to an element

Achievements and ranks

On every achievement and rank edit screen you will see a new meta box named “Expiration” where you can configure the expiration settings for this element.

Simply, open the dropdown to configure the expiration of your choice for this achievement or rank:

You can configure a specific expiration date or a relative one. Here is how each work:

  • Specific date: Setting the expiration to “Specific date” brings you the ability to enter the exact expiration date you want.
  • Relative date: Setting the expiration to a relative date (days, weeks, months or years) brings you the ability to configure an expiration date based on the date the user unlocked this item.
    For example, if you configure an achievement to expire 2 days later, the expiration date will get automatically calculated at the moment the user unlocks it. If user unlocks the achievement the January 1st, then the expiration date will get automatically calculated to January 3rd.

Recalculate option (only for ranks)

For ranks, you can find in the “Expiration” box the “Recalculate” option:

Checking this option will make that, at the moment a rank expires or get revoked, the expiration date for the next rank the user gets moved will get recalculated.

For example, if a rank should expire in 1 day, Expirations add-on commonly calculates it at the moment the user unlocks the rank. The recalculate option, makes that the rank expiration date will be calculated again at the moment its next rank gets expired or revoked.

To better understand this setting, let to show a simple example. Imagine that we have the Rank 3 and Rank 2, both configured to expire in 5 days. Here are the different workflows available depending if recalculate is enabled or not for Rank 2:

Example without the recalculate option:

  • Jan 1st: User unlocks Rank 2 – Expiration date for Rank 2 is set to Jan 6th (5 days after).
  • Jan 2nd: User unlocks Rank 3 – Expiration date for Rank 3 is set to Jan 7th.
  • Jan 7th: User Rank 3 expires – The Rank 3 gets revoked and user gets moved to Rank 2.
  • Since Rank 2 expires in Jan 6th, it also gets revoked since the recalculate option is not marked and user gets moved to Rank 1.

Example with the recalculate option:

  • Jan 1st: User unlocks Rank 2 – Expiration date for Rank 2 is set to Jan 6th.
  • Jan 2nd: User unlocks Rank 3 – Expiration date for Rank 3 is set to Jan 7th.
  • Jan 7th: User Rank 3 expires – The Rank 3 gets revoked and user gets moved to Rank 2.
  • Rank 2 expiration date gets recalculated and now expires on Jan 12th
  • Jan 12th: User Rank 2 expires – The Rank 2 gets revoked and user gets moved to Rank 1.

Requirements (points awards, deducts, steps and rank requirements)

On every requirement (points awards or deducts, steps or rank requirements) will appear a new line starting with the label “Expires:” as you can see on this screenshot:

As in achievements and ranks expiration box, the unique you need is to open the dropdown to configure the expiration of your choice (specific or relative):

Of course, every expiration is configured regardless of the other requirements so, you are able to configure different expiration dates for each requirement of your points, achievements or ranks.

Next, you can check how expirations are displayed at frontend to your users.

Also, you should check how expirations work for certain situations to meet, for example, what happens if an achievement step has an expiration configured and the user unlocks the achievement before the step expiration date.

How can we help?