Every credential has an issue date and, if you wish, an expiration date. The example shows the credential “Workplace First Aider” from Werk Süd GmbH, which is valid for two years.
Step 1: Set the default in the template
Open the template's basic details. Under “Expiration Date” there are three options: “No Expiration”, “Expires” with a fixed date and “Expires after” with a number of months. For a credential that is valid for two years, enter 24 months.
Next to it you set the issue date: “When recipient is added” or a fixed date.
| Option | Effect | Example |
|---|---|---|
| “No Expiration” | The credential is valid indefinitely | Final diploma |
| “Expires” | A fixed date for all credentials of the template | Annual safety briefing, valid until December 31, 2027 |
| “Expires after” | Validity in months | 24 months for the workplace first aider |
Step 2: Deviate for individual people
When adding a single person, switch on “EXPIRATION DATE” under “Issue and Expiration Date” and enter a date of your own. It replaces the template default for that person only. If the field stays empty, the default applies.
Step 3: Pass dates along in a list
When you upload a CSV file, dates are switched off at first. Switch on issue date, expiration date or both and map the matching column. Every value in a column must use the same format.
Step 4: Make the validity visible
The validation page shows the expiration date under “Valid until”. After expiry, a banner appears at the top of the page: the details are still verified, but the issuer no longer considers the credential valid. The expiration date also appears on the wallet card.
Step 5: Issue again after the refresher
When someone has completed the refresher, add the person again. They receive a new credential with a new issue date and expiration date.
If the person is already in the list of recipients with the same email address, switch on “Allow duplicate email addresses” when you add them.
Follow this guide with your own data.
Check the result
- The template shows the intended validity.
- A test credential states the right date under “Valid until” on the validation page.
- Different dates for individual people have been applied.
More on this: Certificate and Badge Management
Frequently asked questions
Which date formats work in the CSV file?
DD/MM/YYYY, MM/DD/YYYY, DD.MM.YYYY, MM.DD.YYYY, YYYY-MM-DD and YYYY/MM/DD.
What happens with faulty dates?
Dates are checked before the upload is completed. For a single person a warning appears; for a list you see the affected rows.
Does this also apply to recipients added via API?
Yes. Without a date of their own, the template default applies, whether people are added one by one, by list or via the REST API.
What if a credential should stop being valid before the expiration date?
Then revoke it. The guide Revoke or replace a certificate shows the steps.