Skip to content

Outlook add-in for Smarter Visitor Registration

Generate the manifest, deploy the add-in centrally for everyone or for specific groups only, and register visitors directly in the Outlook appointment.

What the add-in does

The add-in adds a button to the Outlook appointment. One click registers all invited people as expected visitors and inserts a QR code into the invitation. Visitors use this code to check in at the terminal.

The setup consists of three parts: publish the manifest in the settings, deploy the add-in in the Microsoft 365 admin center and, if you have several locations, define which appointment belongs to which location.

1

Generating and publishing the manifest

The manifest describes the add-in for Outlook: name, button and the address of your installation. You generate it under Settings › Outlook Add-in.

Outlook Add-in tab with the manifest fields
The details for the manifest. The address of the web app and the client ID are already filled in.
FieldMeaning
Provider NameName of your company or of the vendor, as it appears in add-in management.
Display NameName of the add-in and label of the group in the ribbon, for example “Visitor registration”.
DescriptionTooltip text that appears when you hover over the button.
Button LabelText of the button in the appointment, for example “Insert QR code”.
Support URLAddress where your employees can find help.
App registration client ID (Microsoft Entra)The client ID of the app registration. Filled in automatically.
Manifest App ID (optional)Custom identifier of the add-in. Normally leave empty.
VersionVersion of the manifest, for example 2.0.0. Increase it with every change.
  1. Fill in the fields. Choose the display name and button label in the language of your employees.
  2. Click Save & Publish Manifest.
  3. Copy the manifest address shown, https://<name>.azurewebsites.net/manifest.xml, or download the file manifest.xml.
Confirmation after publishing with the manifest address and the download button
After publishing, the manifest is available at a fixed address.

Manifest address

The address of the manifest can be retrieved without sign-in so that the Microsoft 365 admin center can load it. It contains no secrets.

2

Deploying the add-in in the Microsoft 365 admin center

Centralised deployment installs the add-in for the selected people in Outlook for Windows, Mac and on the web. You need the Exchange Administrator or Global Administrator role for this.

  1. Open the Microsoft 365 admin center and select Settings › Integrated apps.
  2. Click Upload custom apps.
  3. Select Office Add-in as the app type.
  4. Select Provide link to manifest file and paste the manifest address. Alternatively, upload the downloaded manifest.xml.
  5. Define who receives the add-in: Just me for the first test, Entire organization or Specific users/groups.
  6. Confirm the permissions and finish the deployment.
Microsoft 365 admin center with the Integrated apps page and the button for uploading custom apps
Integrated apps in the Microsoft 365 admin center. Here you upload the manifest and assign users.

Allow time after the deployment

According to Microsoft, it can take 24 to 72 hours until the add-in appears in the ribbon for everyone. Outlook must be restarted for this. Therefore test with “Just me” first.

3

Rolling out to specific groups or locations only

Who sees the button in Outlook is controlled solely by the assignment in the Microsoft 365 admin center. For a gradual rollout, for example location by location, this approach works well:

  1. Create one group per location, for example “Visitor Registration Vienna”. Use a Microsoft 365 group or a mail-enabled security group.
  2. Assign the add-in to the groups: During deployment, select Specific users/groups and add the groups of the locations that are starting. You add further groups later with Edit users.
  3. Assign the group to the location: Enter the same group in the settings of the location under Access › Outlook assignment groups. Appointments created by these people are then assigned to the correct location automatically.
Access tab of a location with the Outlook assignment groups field
The Outlook assignment groups of a location.

Microsoft restrictions for groups

Centralised deployment supports Microsoft 365 groups, distribution lists and mail-enabled security groups. Security groups without an email address and nested groups are not taken into account. Always assign the add-in to the top-level group.

4

How an appointment is assigned to its location

There is no location selection in Outlook. The system assigns each appointment in this order:

  1. Location of the appointment: If the “Location” field contains exactly the name of a location, this location applies. Upper and lower case do not matter.
  2. Group of the host: If the person who creates the appointment is a member of an Outlook assignment group, the associated location applies.
  3. Primary location: In all other cases, the primary location is used.

Visit at a different location

If you receive guests at a different location as an exception, enter the location name as the location of the appointment. At the terminal of a location, only appointments of this location can be checked in.

5

QR template and attachments

You define what the add-in writes into the appointment for each location under Check-in behavior › Outlook QR code. The template must contain the placeholder {{qrCode}}; {{locationName}} inserts the name of the location.

Editor for the Outlook QR code template with the placeholders qrCode and locationName
A template with a greeting, the QR code and directions.
  • Use the template for everything visitors should know: address, parking, where to report at reception.
  • If behavior guidelines with Attach to Outlook invitation are active at the location, the add-in adds the guidelines files as attachments.
  • Without a custom template, the add-in uses a short default text with the QR code.
6

Registering visitors in the appointment

  1. Create a new appointment in Outlook and add the visitors as attendees.
  2. Enter the subject, the time and, if you have several locations, the location.
  3. Click the add-in button in the ribbon. After a few seconds, the QR code is in the appointment.
  4. Send the invitation as usual.
Apps menu in the Outlook appointment with the Smarter Visitor Registration entry
Outlook on the web: the add-in is listed under “Apps” in the appointment. In Outlook for Windows it appears as a button on the ribbon.
Outlook appointment with the add-in button and the inserted QR code
One click on the button inserts the QR code and registers the attendees as visitors.
  • All attendees count as visitors: required and optional, internal and external. Only the organiser is excluded.
  • The content of the appointment is replaced. Insert the QR code first and write your invitation text afterwards, or store it in the template.
  • Click again after changes: If you change attendees, time or location, click the button once more. The QR code stays the same, and the registration is updated.
  • The registered people appear immediately as “Planned” in the analytics of the location.
7

Updating the manifest or removing the add-in

  • Changing the label or name: Adjust the fields in the settings, increase the version and publish again. Then open the add-in under Integrated apps and select Update add-in.
  • Changing the assignment: Open the add-in under Integrated apps and select Edit users.
  • Removing: In the same area, select Remove app. QR codes that have already been sent remain valid.
8

Frequently asked questions

In which Outlook versions does the add-in work?

In Outlook on the web, in the new Outlook for Windows and in current versions of Outlook for Windows and Mac with Exchange Online. The button is not available in the Outlook mobile apps.

The button does not appear.

Check whether the person is assigned to the add-in, and wait for the rollout to complete. The button only appears in appointments that you organise yourself, not in emails and not in invitations from other people. Restarting Outlook often helps.

The QR code is not created.

The add-in signs in to your installation with the Outlook account. Check whether the web app is reachable and whether the account belongs to the same tenant. If the name of the web app has been changed, publish the manifest again.

The terminal says that the appointment does not belong to this location.

The appointment was assigned to a different location. Check the location in the appointment and the Outlook assignment groups. After a correction, the host clicks the button in the appointment again.

Can I exclude internal attendees from the registration?

No, the add-in registers all attendees. Internal people who do not check in remain in the analytics as “Planned” and disappear from the daily view on the following day.

Questions about this product?

Our support team is happy to help with any questions about Smarter Visitor Registration.