Overview
Use the Pending Users App to invite one or more people to your Softools Site. Choose their Teams and Permission Sets, enter their email addresses and select Invite.
You can select built-in Permission Sets or custom sets created for your organisation, such as Contributor or Data Steward. This gives you control over the permissions applied when inviting Users, without selecting each permission individually afterwards.
For Users following the usual registration process, send an invitation email so they can complete their account registration. For Users joining through an already configured Single Sign-On (SSO) connection, you can create the invitation without sending that email; their first SSO login verifies their account.
Choose Teams and Permission Sets, enter one email address per line, and choose whether to send an invitation email.
Contents
- Before you start
- Open the invitation screen
- Choose Teams and Permission Sets
- Enter email addresses
- Choose whether to send an invitation email
- Review the invitation results
- View Pending Users
- Resend an invitation email
- Check email delivery and resolve problems
- Invitation reminders and expiry
- Update permissions after verification
Before you start
You need the appropriate administration permissions to access Pending Users and invite Users.
Decide which Teams and permissions the new Users need. If you want to use a custom Permission Set, create it first. See User Account Permission Sets.
Each email address must be unique on the Site. If someone already has an account, manage that account rather than creating another one.
Open the invitation screen
- Open the Launchpad in the top-left corner of the Site.
- Select the cog within the Launchpad to display the settings Apps.
- Open Pending Users.
Open Pending Users from the settings Apps in the Launchpad.
- Open the ellipsis (…) menu in the top-right corner and select Invite.
Select Invite from the Pending Users report menu.
The Invite users to Softools window opens. Teams appear on the left, Permission Sets on the right, and the email address box below.
Choose Teams and Permission Sets
Select the required Teams in the left-hand panel and Permission Sets in the right-hand panel. You can select more than one of each. Scroll within either panel to see further options.
| Selection | Purpose |
|---|---|
| Teams | Help determine which Apps and Records the User can access, according to the security configured on your Site. |
| Permission Sets | Determine which actions the User can perform, such as creating, updating or exporting Records. |
If Teams have been set up on your Site, a new User must belong to at least one Team.
The Permission Sets panel includes built-in sets provided by Softools and custom sets created by your administrators. Choose the combination that matches the User’s responsibilities.
Example: invite Contributors
In the overview screenshot, the Softools Team and the custom Contributor Permission Set are selected. This example Contributor set includes:
| Category | Permissions included |
|---|---|
| Record Permissions | Create, Update, Copy, Export |
| Report Permissions | Export |
| Activity Stream Permissions | All Activity Stream Permissions |
| Settings Permissions | None |
| App Studio Permissions | None |
It provides a reusable starting point for everyday data entry and collaboration. Your own custom sets can contain different combinations to suit your organisation.
If you select several Permission Sets, their permissions are combined. Review the full combination before inviting the Users.
For instructions on creating sets and reviewing their contents, see User Account Permission Sets.
Enter email addresses
Enter each person’s email address in the email address box, with one address per line.
All Users in the same batch receive the same selected Teams and Permission Sets. Use separate batches for groups that need different access, permissions or invitation email settings.
The example screenshot includes three addresses. One already belongs to an account on the Site; the results later in this guide show how Softools reports that alongside the successful invitations.
Choose whether to send an invitation email
Use Send invitation email according to how the Users will sign in:
| Sign-in method | Send invitation email | What the User does next |
|---|---|---|
| Usual account registration | Leave selected. | Follow the email link to complete registration and set a password, including a username where required by the Site. |
| Single Sign-On (SSO) | Untick for Users joining through your configured SSO connection. | Sign in using the organisation’s SSO route. Their first login verifies the account. |
SSO Users do not follow the usual invitation email process to create a separate Softools password. The checkbox controls whether an invitation email is sent; it does not configure SSO.
Review the email addresses, Teams, Permission Sets and email option, then select Invite.
Review the invitation results
After selecting Invite, review the feedback in the invitation window. A batch can contain both successful and unsuccessful invitations.
In this example:
- Two Users were successfully invited: tom.baker@example.com and alan.gates@example.com.
- One invitation failed: the address mark.dyer@softools.net was already in use on the Site.
Review the successful invitations and the reason for any failures.
For an address already in use, check the existing account or pending invitation. Resolve any other reported failures before retrying the affected addresses.
A successful invitation result does not confirm email delivery or completed registration. Those are separate stages.
View Pending Users
Close the invitation window to return to Pending Users. Successfully invited Users appear in the list. Use search or filtering to find a particular email address.
The two successfully invited Users appear in the Pending Users list.
Open a pending entry to review its details, including the email address and invitation expiration.
Open a Pending User to review their email address and invitation expiration.
Users remain pending until their account is verified:
- Users following the usual registration process complete it through their invitation link.
- SSO Users remain pending until their first SSO login verifies their account.
For the usual registration steps, see Verifying your Softools Account and Creating a Password.
Resend an invitation email
If a User needs another registration email, first check that their email address is correct.
- Open their entry in Pending Users.
- Open the ellipsis (…) menu.
- Select Resend Email.
Select Resend Email from the Pending User’s menu.
- Check the address in the confirmation message and select Yes.
Confirm the email address before resending the invitation.
Sending a new verification request invalidates earlier invitation links. Ask the User to use the most recent email.
For SSO Users, follow the SSO sign-in route described above rather than resending a password-registration email.
For more information, see Re-Inviting an Unverified User.
Check email delivery and resolve problems
To investigate an invitation email:
- Open the User’s entry in Pending Users.
- Open the ellipsis (…) menu.
- Select Email Activity.
Open Email Activity to review invitation email delivery information.
The activity window displays recent email information, including the status and any recorded open or click counts. The feed is delayed, so allow time for updates before checking again.
The activity feed can help investigate delivery problems. This example shows a not_delivered status.
| What you see | What to check |
|---|---|
not_delivered |
Check the email address for mistakes and review any available delivery information. An incorrect address or mail filtering may be involved; the status alone does not establish the cause. |
| Delivered, but the User cannot find the email | Ask them to check junk or spam folders. Their IT team may need to check filtering or quarantine. Delivery to a mail server does not guarantee inbox placement. |
| No activity or no recent update | Allow time for the feed to update. Also check whether Send invitation email was selected; an email intentionally not sent for an SSO User will not have a delivery event to review. |
Correct an incorrect email address
If the address is wrong, delete the incorrect Pending User entry and create a new invitation with the correct address.
Open the incorrect entry, select Delete from its ellipsis menu, then return to Invite and enter the correct address. Select the required Teams and Permission Sets again for the new invitation.
Resending the existing invitation sends it to the same incorrect address, so it will not resolve an address mistake.
For more information, see Email Activity for Users and Pending users.
Invitation reminders and expiry
For Users following the invitation email registration route:
- Reminder emails are sent each Monday for four weeks after the initial invitation if it remains unused.
- During this reminder period, only the most recent invitation link is valid.
- If the invitation remains unused after the fourth reminder, the link in that final email remains valid for 100 days.
- After that period, an administrator needs to resend the invitation manually.
You can review the Expiration value on the Pending User record. SSO Users verify through their first SSO login rather than the email registration link.
Update permissions after verification
Once the User’s account is verified, open their account in the Users App and select Permissions. You can use Apply Permission Set, Remove Permission Set or the individual permission checkboxes to update what they can do.
Permission Sets are reusable templates. Editing a set later does not automatically change the permissions of Users who previously received it.
For the full explanation, including changing a User’s role and removing permissions shared between sets, see User Account Permission Sets.
Comments
0 comments
Article is closed for comments.