← Blog

Guide

Inviting people by e-mail

Invite a new user by email so they choose their own password. Resend, cancel or copy the link when the email does not reach them.

This is part of Qorekit 0.3, out now as a beta: download 0.3.0-beta.1. As with any beta, keep a backup of anything you cannot afford to lose.

With Qorekit 0.3 you no longer have to make up a password for every new colleague. You invite them by email, they choose their own password, and nobody else ever knows it.

This post walks through sending an invitation, following it up and what to do when the email does not arrive.

Before you start

Invitations go out by email, so email should be set up first in Administration › Email. The post on setting up email shows how. If it is not set up yet, you can still invite people and pass the link on yourself, as described below.

You need to be an administrator, or have a role with the permission Invite, edit and deactivate users.

Sending an invitation

  1. Open Administration › Users and choose New user.
  2. Enter their first name, last name and email. The email is what they sign in with.
  3. Leave Email an invitation to choose their own password ticked. It is ticked for every new user.
  4. Choose their roles, and their main role if they have more than one.
  5. Save.

Qorekit emails them a link. They open it, choose a password on the page it opens and are signed in at once.

The link works for a week, and once. After it has been used, or after the week, it does nothing.

After saving, the dialog shows the link too. Copy it if you want to pass it on yourself, in a chat message or a phone call.

This helps when the email does not arrive, for example because it landed in a spam folder or because email is not set up yet. The link is shown only then. If you need one later, Send again emails a new link, as described below.

Following up

Until they accept, the users list shows the person as Invited. When the week runs out, it shows Invitation expired.

Select the person to see their invitation. Their details say when it was sent and until when it works, with two buttons:

  • Send again sends a new link. The old one stops working.
  • Cancel the invitation withdraws it, for example if you invited the wrong address.

If you change your mind and give them a password yourself, that also ends the invitation.

Giving a password instead

Some people never read their email, or you may be setting up an account you will hand over in person. Clear the invitation box when you add the user and enter a password of at least 8 characters. Tell them the password yourself. They can change it after signing in, from Account and security in the account menu.

The same kind of link helps people who already have an account but cannot get into it. In their details, choose Send a link to choose a password.

They get an email with a link to choose a new password. Their current password keeps working until they choose a new one.

People can also ask for such a link themselves, with Forgot your password? on the sign-in page. The post on forgotten passwords and signed-in browsers covers that side.

When a user manager invites

A user manager is someone whose role allows Invite, edit and deactivate users, without being an administrator. They can invite people, but only give the roles their own roles allow. A team lead might be able to give Sales only, never Administrator.

They can send again or cancel an invitation only for users whose every role they could have given themselves.

The audit log

Invitations are part of the audit log, with the other changes to users. You can look up later who invited whom.

Read more

The users page of the documentation covers invitations and user managers. Invitations arrive with Qorekit 0.3.0.