# Office plugin registry keys

## Introduction

Which registry keys can you use to change the behavior of the Zivver Office Plugin in Outlook?

Each chapter has four sections.

- How does a setting work
- When to use this setting?
- How to enable
- How to disable

## Table of contents

01. [Change account cache location](https://docs.zivver.com/en/admin/officeplugin/registry-keys.html#account-caching-stored-on-different-location)
02. [Automatic File Decryption](https://docs.zivver.com/en/admin/officeplugin/registry-keys.html#automatic-file-decryption)
03. [Automatic log in via SSO](https://docs.zivver.com/en/admin/officeplugin/registry-keys.html#automatic-login-via-sso)
04. [Extend active session duration](https://docs.zivver.com/en/admin/officeplugin/registry-keys.html#extend-active-session-duration)
05. [Do not show user tutorials](https://docs.zivver.com/en/admin/officeplugin/registry-keys.html#do-not-show-user-tutorials)
06. [Turn off WebSockets](https://docs.zivver.com/en/admin/officeplugin/registry-keys.html#turn-off-websockets)
07. [Enable unsecure forwarding of Zivver messages](https://docs.zivver.com/en/admin/officeplugin/registry-keys.html#enable-unsecure-forwarding-of-zivver-messages)
08. [Exempt recipient domains from business rules checks](https://docs.zivver.com/en/admin/officeplugin/registry-keys.html#exempt-recipient-domains-from-business-rules-checks)
09. [Block users from sending with Zivver](https://docs.zivver.com/en/admin/officeplugin/registry-keys.html#block-users-from-sending-with-zivver)
10. [Plugin assisted mail submission](https://docs.zivver.com/en/admin/officeplugin/registry-keys.html#plugin-assisted-mail-submission)
11. [Enable attachments with plugin assisted mail submission](https://docs.zivver.com/en/admin/officeplugin/registry-keys.html#enable-attachments-with-plugin-assisted-mail-submission)
12. [Use email verification by default](https://docs.zivver.com/en/admin/officeplugin/registry-keys.html#use-email-verification-by-default)
13. [Set maximum attachment size for unencrypted messages](https://docs.zivver.com/en/admin/officeplugin/registry-keys.html#set-maximum-attachment-size-for-unencrypted-messages)
14. [Enable debug mode](https://docs.zivver.com/en/admin/officeplugin/registry-keys.html#enable-debug-mode)
15. [Make sure the plugin is always enabled](https://docs.zivver.com/en/admin/officeplugin/registry-keys.html#enable-plugin-always)
16. [Enable fallback host](https://docs.zivver.com/en/admin/officeplugin/registry-keys.html#enable-fallback-host)
17. [Detect Purview labels of emails](https://docs.zivver.com/en/admin/officeplugin/registry-keys.html#detect-purview-labels)

## Account caching stored on different location

### How does AccountCacheLocation work

This setting changes the location where the plugin stores cached files. These cached files are stored in the user roaming profile `%AppData%\Zivver\OfficePlugin\accounts\<user_id>\cache` by default.

**Requirements**

- The location is within the user’s home folder or is in a folder that the user has (writing) rights to.
- The folder is automatically emptied after ending the user session.
- The folder is on a physical device that reads and writes reasonably fast 1. Preferably it has the same physical drive as the installation of Outlook itself.

1) Flash-based storage, like SSD, NVMe or PCI-E storage devices.

### When to use AccountCacheLocation

Turn this setting on during troubleshooting of performance issues.

### How to enable AccountCacheLocation

In the table below `%Temp%` is used as an example location on the drive.

| Key | Type | Name | Value |
| --- | --- | --- | --- |
| HKEY_CURRENT_USER\\SOFTWARE\\Zivver\\OfficePlugin\\Settings | REG_SZ | AccountCacheLocation | %Temp% |

### How to disable AccountCacheLocation

| Key | Type | Name | Value |
| --- | --- | --- | --- |
| HKEY_CURRENT_USER\\SOFTWARE\\Zivver\\OfficePlugin\\Settings | REG_SZ | AccountCacheLocation | %AppData%\\Zivver\\OfficePlugin\\email_data |

## Automatic file decryption

### How does EnableAutomaticFileDecryption work

This setting enables the automatic decryption of files that are received via Zivver.

### When to use EnableAutomaticFileDecryption

When your organization has the policy to store unencrypted copies of Zivver messages and their attachments, for example for archiving purposes.

This setting can be disabled to improve performance.

### How to enable EnableAutomaticFileDecryption

The setting is enabled by default.

| Key | Type | Name | Value |
| --- | --- | --- | --- |
| HKEY_CURRENT_USER\\SOFTWARE\\Zivver\\OfficePlugin\\Settings | DWORD | EnableAutomaticFileDecryption | 1 |

### How to disable EnableAutomaticFileDecryption

Use the registry key below to disable automatic file decryption.

| Key | Type | Name | Value |
| --- | --- | --- | --- |
| HKEY_CURRENT_USER\\SOFTWARE\\Zivver\\OfficePlugin\\Settings | DWORD | EnableAutomaticFileDecryption | 0 |

## Automatic login via SSO

[Read all about the “Automatic login via SSO” registry key](https://docs.zivver.com/en/admin/officeplugin/references/automatic-login-outlook-plugin-and-sso.html)

## Extend active session duration

Available from Office plugin version 5.4.10 and higher.

### How does ShortRefreshTokenSSOTTLHours work

This setting extends the duration a user stays logged in to the Office plugin. By default the session duration is 12 hours. This means users have to log in to Zivver every 12 hours, which in practice means every day.

### When to use ShortRefreshTokenSSOTTLHours

When your organization uses the Office Plugin in controlled working environments such as Citrix or Remote Desktops it makes sense to extend the duration. This will improve the user experience because users are logged in for a longer period of time in Zivver.

Note

**Do not use on personal or public devices**

Zivver does not recommend to use this setting on personal or public devices.

### How to enable ShortRefreshTokenSSOTTLHours

The example below sets the value for the `ShortRefreshTokenSSOTTLHours` to `720` (in hours), which is roughly equal to a token that expires every month. You can change the value to any value that you like as long as this potential security risks for extended token duration is considered.

| Key | Type | Name | Value |
| --- | --- | --- | --- |
| HKEY_CURRENT_USER\\SOFTWARE\\Zivver\\OfficePlugin\\Settings | DWORD | ShortRefreshTokenSSOTTLHours | 720 (decimals) |

### How to disable ShortRefreshTokenSSOTTLHours

This setting is always enabled, however you can revert back to default by using 12 as value.

| Key | Type | Name | Value |
| --- | --- | --- | --- |
| HKEY_CURRENT_USER\\SOFTWARE\\Zivver\\OfficePlugin\\Settings | DWORD | ShortRefreshTokenSSOTTLHours | 12 (decimals) |

## Do not show user tutorials

### How does DoNotShowTutorials work

This setting determines if users see a tutorial when the user is first logged in to the Zivver Office Plugin. The tutorial shows the main points in the Office Plugin and can be skipped by the user.

### When to use DoNotShowTutorials

When your organization is implementing Zivver and users are being exposed to the Office Plugin for the first time. If your organization provides user training for the Office Plugin for each user, then this setting may be disabled.

### How to enable DoNotShowTutorials

When enabled the user will not see any Zivver tutorials.

| Key | Type | Name | Value |
| --- | --- | --- | --- |
| HKEY_CURRENT_USER\\SOFTWARE\\Zivver\\OfficePlugin\\Settings | DWORD | DoNotShowTutorials | 1 |

### How to disable DoNotShowTutorials

This setting is disabled by default.

| Key | Type | Name | Value |
| --- | --- | --- | --- |
| HKEY_CURRENT_USER\\SOFTWARE\\Zivver\\OfficePlugin\\Settings | DWORD | DoNotShowTutorials | 0 |

## Turn off WebSockets

### How does ZivverWebSocket work

With this setting, the Office Plugin can dynamically update information displayed by the plug-in via WebSockets, such as message contents.

### When to use ZivverWebSocket

When Zivver recommends to turn this setting off during troubleshooting or performance issues.

### How to enable ZivverWebSocket

WebSockets are enabled by default.

| Key | Type | Name | Value |
| --- | --- | --- | --- |
| HKEY_CURRENT_USER\\SOFTWARE\\Zivver\\OfficePlugin\\Settings | REG_SZ | ZivverWebSocket | On |

### How to disable ZivverWebSocket

| Key | Type | Name | Value |
| --- | --- | --- | --- |
| HKEY_CURRENT_USER\\SOFTWARE\\Zivver\\OfficePlugin\\Settings | REG_SZ | ZivverWebSocket | Off |

## Enable unsecure forwarding of Zivver messages

### How does EnableUnsecureForwarding work

With this setting, a user can forward Zivver messages unencrypted. That means, in an unsecure manner.

### When to use EnableUnsecureForwarding

When users are required to forward sensitive information unencrypted for a specific (internal) workflow.

### How to enable EnableUnsecureForwarding

This setting is enabled by default.

| Key | Type | Name | Value |
| --- | --- | --- | --- |
| HKEY_CURRENT_USER\\SOFTWARE\\Zivver\\OfficePlugin\\Settings | REG_SZ | EnableUnsecureForwarding | True |

### How to disable EnableUnsecureForwarding

| Key | Type | Name | Value |
| --- | --- | --- | --- |
| HKEY_CURRENT_USER\\SOFTWARE\\Zivver\\OfficePlugin\\Settings | REG_SZ | EnableUnsecureForwarding | False |

## Exempt recipient domains from business rules checks

[Read all about the “HighlyConfidentialDomains” registry key](https://docs.zivver.com/en/admin/officeplugin/exempt-domains-from-business-rule-checks.html)

## Block users from sending with Zivver

Available from Office Plugin version 5.4.10 and higher.

### How does HighlyConfidentialDomainsBlocksZivverSending work

This setting blocks users from sending a Zivver message when a domain is on the [HighlyConfidentialDomains list](https://docs.zivver.com/en/admin/officeplugin/exempt-domains-from-business-rule-checks.html). It is required to have the HighlyConfidentialDomains list enabled before enabling this setting.

### When to use HighlyConfidentialDomainsBlocksZivverSending

The Zivver Office Plugin checks draft messages for business rules violations by default. This check is performed by the Zivver backend in the cloud. However, laws or organizational policies might mandate that you must not send some messages to the cloud.

### How to enable HighlyConfidentialDomainsBlocksZivverSending

Note

**Only enable together with HighlyConfidentialDomains**

It is required to have the [HighlyConfidentialDomains list](https://docs.zivver.com/en/admin/officeplugin/exempt-domains-from-business-rule-checks.html) enabled before enabling this setting.

| Key | Type | Name | Value |
| --- | --- | --- | --- |
| HKEY_CURRENT_USER\\SOFTWARE\\Zivver\\OfficePlugin\\Settings | DWORD | HighlyConfidentialDomainsBlocksZivverSending | 1 |

### How to disable HighlyConfidentialDomainsBlocksZivverSending

This setting is disabled by default.

| Key | Type | Name | Value |
| --- | --- | --- | --- |
| HKEY_CURRENT_USER\\SOFTWARE\\Zivver\\OfficePlugin\\Settings | DWORD | HighlyConfidentialDomainsBlocksZivverSending | 0 |

## Plugin Assisted Mail Submission

Refer to [Enable PAMS in the Zivver Office Plugin](https://docs.zivver.com/en/admin/officeplugin/pams/enable-pams-in-the-zivver-office-plugin.html).

## Enable attachments with Plugin Assisted Mail Submission

### How does EnableZivverAttachmentsWithMailAssistedSubmission work

This setting disables the Zivver paperclip button to add large attachments to Zivver messages when the [Plugin assisted mail submission](https://docs.zivver.com/en/admin/officeplugin/pams/enable-pams-in-the-zivver-office-plugin.html) is enabled.

### When to use EnableZivverAttachmentsWithMailAssistedSubmission

You can enable this setting if your organization does not want to send emails with large attachments. The maximum attachment size depends on the maximum message size configured in your mail server.

You can disable this setting if your organization requires all attachments to pass through your mail server, for example for document management software.

### How to enable EnableZivverAttachmentsWithMailAssistedSubmission

This setting is enabled by default.

| Key | Type | Name | Value |
| --- | --- | --- | --- |
| HKEY_CURRENT_USER\\SOFTWARE\\Zivver\\OfficePlugin\\Settings | DWORD | EnableZivverAttachmentsWithMailAssistedSubmission | 1 |

### How to disable EnableZivverAttachmentsWithMailAssistedSubmission

| Key | Type | Name | Value |
| --- | --- | --- | --- |
| HKEY_CURRENT_USER\\SOFTWARE\\Zivver\\OfficePlugin\\Settings | DWORD | EnableZivverAttachmentsWithMailAssistedSubmission | 0 |

## Use email verification by default

### How does UseEmailVerificationAsDefault work

This setting automatically applies “ [Email verification](https://docs.zivver.com/en/guest/verification-methods.html#verification-level-1)” instead of prompting the user to set a [verification method](https://docs.zivver.com/en/guest/verification-methods.html) for added security. This setting decreases the average security of all sent Zivver messages. If a verification method is already available in Zivver for the recipient, then that verification method will be used over Email verification.

This setting is enabled by default for version 5.4.12 and higher.

### When to use UseEmailVerificationAsDefault

When your organization has all available verification methods uploaded in Zivver and you want to use Email Verification for all other Zivver messages.

### How to enable UseEmailVerificationAsDefault

This setting is enabled by default for version 5.4.12 and higher.

| Key | Type | Name | Value |
| --- | --- | --- | --- |
| HKEY_CURRENT_USER\\SOFTWARE\\Zivver\\OfficePlugin\\Settings | DWORD | UseEmailVerificationAsDefault | 1 |

### How to disable UseEmailVerificationAsDefault

| Key | Type | Name | Value |
| --- | --- | --- | --- |
| HKEY_CURRENT_USER\\SOFTWARE\\Zivver\\OfficePlugin\\Settings | DWORD | UseEmailVerificationAsDefault | 0 |

## Set maximum attachment size for unencrypted messages

### How does MaxSizeForAttachmentsToAttachToMail work

Email attachments are saved with the email when Zivver messages are stored locally unencrypted. Attachments larger than 5 megabyte (MB) will referenced to by a download link to the Zivver portal. Reasoning for this feature is that attachments of Zivver messages can be much larger than the standard 20 MB attachment size of Microsoft Exchange server.

With this setting, you can set the maximum email size that is saved unencrypted so that it matches your Exchange maximum email size.

### When to use MaxSizeForAttachmentsToAttachToMail

Use this setting when you need to save emails that are larger than 20 MB together with the attachments.

### How to enable MaxSizeForAttachmentsToAttachToMail

| Key | Type | Name | Value |
| --- | --- | --- | --- |
| HKEY_CURRENT_USER\\SOFTWARE\\Zivver\\OfficePlugin\\Settings | REG_DWORD | MaxSizeForAttachmentsToAttachToMail | 50 |

The above example makes emails possible with attachments up to 50 MB in size. The value needs to be a decimal and can be smaller or larger than the example above. The value should not exceed the Exchange attachment size limit.

### How to disable MaxSizeForAttachmentsToAttachToMail

| Key | Type | Name | Value |
| --- | --- | --- | --- |
| HKEY_CURRENT_USER\\SOFTWARE\\Zivver\\OfficePlugin\\Settings | REG_DWORD | MaxSizeForAttachmentsToAttachToMail | 20 |

## Enable debug mode

Warning

Enable this setting only when Zivver recommends you to. Enabling debug mode results in more storage from the Office plugin in the form of logfiles.

### How does the debug mode work

This setting enables additional logging for debug purposes. The log files are stored for each user under `%appdata%/zivver/officeplugin`

### When to use debug mode

Enable this setting when Zivver support recommends during troubleshooting.

### How to enable debug mode in Office plugin version 6 and higher

| Key | Type | Name | Value |
| --- | --- | --- | --- |
| HKEY_CURRENT_USER\\SOFTWARE\\Zivver\\OfficePlugin\\Settings | REG_SZ | RemoteLoggingLevel | Trace |
| HKEY_CURRENT_USER\\SOFTWARE\\Zivver\\OfficePlugin\\Settings | REG_SZ | FileLoggingLevel | Trace |

### How to enable debug mode in Office plugin version 5 and lower

| Key | Type | Name | Value |
| --- | --- | --- | --- |
| HKEY_CURRENT_USER\\SOFTWARE\\Zivver\\OfficePlugin\\Settings | REG_SZ | RemoteLoggingLevel | Debug |
| HKEY_CURRENT_USER\\SOFTWARE\\Zivver\\OfficePlugin\\Settings | REG_SZ | FileLoggingLevel | Debug |

### How to revert back to the default setting for any version

| Key | Type | Name | Value |
| --- | --- | --- | --- |
| HKEY_CURRENT_USER\\SOFTWARE\\Zivver\\OfficePlugin\\Settings | REG_SZ | RemoteLoggingLevel | Warning |
| HKEY_CURRENT_USER\\SOFTWARE\\Zivver\\OfficePlugin\\Settings | REG_SZ | FileLoggingLevel | Info |

## Make sure the plugin is always enabled

### How does “always enable the plugin” work

**Always enable the plugin** is different from all the other registry keys described before. Outlook has some checks that will disable plugins that slow down the loading of Outlook at the start. To prevent this from happening multiple registy keys needs to be added and updated.

### When to use “always enable the plugin”

It should be a default to always enable the plugin.

### How to enable “always enable the plugin”

Please see [Make sure that the plugin is enabled at all times](https://docs.zivver.com/en/admin/officeplugin/references/enforce-outlook-plugin-always-enabled.html) for the full explanation to always enable the plugin.

### How to disable “always enable the plugin”

To disalbe “always enable the plugin” you delete all the registry keys you created according to the [Make sure that the plugin is enabled at all times](https://docs.zivver.com/en/admin/officeplugin/references/enforce-outlook-plugin-always-enabled.html) manual.

## Enable fallback host

### How does EnableFallbackHost work

This setting enables an IPV-4 host as fallback host. When the Zivver Office Plugin fails to connect with the IPV-6 host, the plugin will automatically switch to the IPV-4 host.

### When to use EnableFallbackHost

This setting should be used when the Zivver Office Plugin is having problems caused by connection issues with the defualt IPV-6 host.

### How to enable EnableFallbackHost

This setting is enabled by default for version 6.9.0 and higher and should only be disabled when instructed by Zivver.

| Key | Type | Name | Value |
| --- | --- | --- | --- |
| HKEY_CURRENT_USER\\SOFTWARE\\Zivver\\OfficePlugin\\Settings | DWORD | EnableFallbackHost | 1 |

### How to disable EnableFallbackHost

| Key | Type | Name | Value |
| --- | --- | --- | --- |
| HKEY_CURRENT_USER\\SOFTWARE\\Zivver\\OfficePlugin\\Settings | DWORD | EnableFallbackHost | 0 |

## Detect purview labels of emails

### How does EnableMSIPLabels work

With this setting, the Zivver Office Plugin detects Microsoft Purview labels directly applied to emails when the Microsoft Purview Business Rules are enabled.

Info

Purview labels in attachments are already detected by the Zivver Office Plugin without this setting enabled.

### When to use EnableMSIPLabels

When your organization uses Microsoft Purview labels to classify emails and you want the Zivver Office Plugin to detect these labels and apply the correct Zivver Business Rules.

### How to enable EnableMSIPLabels

| Key | Type | Name | Value |
| --- | --- | --- | --- |
| HKEY_CURRENT_USER\\SOFTWARE\\Zivver\\OfficePlugin\\Settings | DWORD | EnableMSIPLabels | 1 |

### How to disable EnableMSIPLabels

| Key | Type | Name | Value |
| --- | --- | --- | --- |
| HKEY_CURRENT_USER\\SOFTWARE\\Zivver\\OfficePlugin\\Settings | DWORD | EnableMSIPLabels | 0 |

Updated on 2026-06-18