InnerWeb
Skip to main content

Activation link: pitfalls of the button in the invitation e-mail

The personalised activation link is in the e-mail only inside the training block. Switching that block off leaves the button leading to the ordinary login screen, where a person without a password can do nothing. We describe the mechanics of the link, the typical implementation pitfalls and a safe way to adapt the invitation template.

7 days
validity of the activation token
Source: invitation function documentation
1
activation link in one e-mail
Source: invitation function documentation

What the activation link consists of

The activation link has the form of the instance address with the fragment account/start, an identifier and a token. The invitation creates an inactive account with an empty password and sends one e-mail with one such link. The link is the only route by which the new person goes from the invitation to a working account.

The token stays valid for 7 days, and simply opening the link does not use it up. If a mandatory training is waiting on the account, the link leads to the training first, and the password is set only after it. Without a training, it leads straight to setting the password.

Pitfall: the link is only in the training block

In the invitation e-mail template, the personalised activation link appears only in the training block. This is by design: the training is the first step of the path, so the button leading to it carries the link.

The consequence falls on the template administrator. Switching off the training block, for example to shorten the message, leaves the button leading to the ordinary login screen. A person who does not yet have a password has nothing to do there: they cannot set a password, cannot start the training and cannot see an explanation. From their point of view the invitation does not work.

Why it cannot be done any other way

An administrator may feel that the button and the block are two independent elements, and that the block can be removed without side effects. The mechanics, however, are such that the block is not decoration but the carrier of personalisation: without it, the address with the token does not reach the button.

For this reason we recommend treating the training block as a mandatory element of the invitation template. Its content, heading and signature can be adapted, but not its presence. If the plant does not run an induction training, another invitation path must be agreed, rather than removing the block from the existing template.

Second trace: clicking again after activation

A person who has activated the account but has not set a password, and who clicks the same link again, lands on the login screen, where there is no password field. The symptom is the same as after removing the training block, but the cause is different: the state of the account, not the template.

For support this distinction matters. When several people report a login screen with no way to set a password, first check the e-mail template, and only then the state of the accounts.

What to check before changing the template

Test every change to the invitation template on a test account. Send an invitation, open the link and walk the path to the end. Because opening the link does not use up the token, the test is safe and does not require creating another account for each attempt.

Only after a successful test does the template go into production invitations. The implementation documentation records the date of the test and the template version, which makes diagnosis easier when someone reports a problem with an invitation months later.

  • do not switch off the training block in the invitation template
  • test content changes on a test account
  • for reports of "I cannot set a password", check the template first
  • record the date and version of the template in the implementation documentation

Video

Frequently asked questions

Can an administrator switch off the training block in the e-mail?

Technically yes, but the personalised activation link is only in that block. Once it is switched off, the button leads to an ordinary login screen where a person without a password can do nothing.

Does testing the link use up the token?

No. Simply opening the link does not use up the token, which stays valid for 7 days, so the test is safe.

Why does clicking again not allow a password to be set?

After the account is activated without a password being set, the same link leads to a login screen with no password field. The symptom resembles the effect of a switched-off training block, but the cause is the state of the account.

Check the invitation template before deployment

We will walk through the invitation path on a test account together and agree which elements of the template can be safely adapted.

Let's talk