This article provides several troubleshooting resources that help to resolve your issue as quickly as possible.

If you are unable to resolve the issue, please contact Hoxhunt Support.

TIP: Hoxhunt button is available in various Outlook clients. You may be able to temporarily circumvent the issue by using another Outlook client such as Web Outlook or Mobile Outlook.

How to resolve issues related to Hoxhunt button visibility

Troubleshooting missing Hoxhunt button

Hoxhunt button is greyed out or it sometimes goes missing

Hoxhunt button's icon doesn't display correctly

How to resolve Hoxhunt error codes

Hoxhunt error codes

How to resolve ADD-IN ERROR

ADD-IN ERROR

ADD-IN ERROR (due to corrupted Legacy Edge)

How to perform basic connectivity checks

Basic connectivity checks can help resolving both task pane issues as well as results window issues. Basic connectivity checks (for signed-in Hoxhunt users only: How to use the Hoxhunt Knowledge base)

How to run Hoxhunt's embedded debugger

Hoxhunt's embedded debugger can be used to troubleshoot task pane issues. Please see Debugging Hoxhunt add-in with embedded debugger (for signed-in Hoxhunt users only: How to use the Hoxhunt Knowledge base)

Task pane related issues

Error: "There was a problem with the report."

Officejs_add-in_task_pane_error_there_was_a_problem_with_the_report.png

Explanation: Pop-up blocker is preventing Hoxhunt from opening a new window.

Solution: Allow pop-ups for *.hoxhunt.com in the following browsers until the issue is resolved:

Your default web browser
Microsoft Edge
Microsoft Internet Explorer

Error: "Failed to open the dialog."

Explanation: When user reports an email in Web Outlook, they are asked for permission to open a new window. If user selects Ignore, this message appears.

Solution: Report the email again, but this time click Allow when asked to allow displaying a new window.

Add-in task pane doesn't load properly

SCENARIO #1 - Windows users: after clicking Hoxhunt button, task pane doesn't load properly.

Side pane is not loading properly.

Explanation: Proxy or firewall might be blocking Hoxhunt's communications with the back-end server. please see a list of critical domains that must be accessible for Hoxhunt add-in to work properly.

Action: Try with a different network configuration (VPN/Proxy disabled, etc.). If issue persists, please contact Hoxhunt Support for assistance.

Less common (legacy) root causes:

Some Outlook clients still use Internet Explorer for rendering add-in content. Something is forcing officejs.hoxhunt.com to be displayed in Compatibility View. Hoxhunt doesn't work in Compatibility View.

A. Turn off Compatibility View:

Open Internet Explorer.
Select Tools (gear icon) > Compatibility View Settings.
Under Websites you've added to Compatibility View field, remove any sites containing "hoxhunt.com".
Uncheck Display Intranet sites in Compatibility View.
Restart Outlook and try again.

If this doesn’t fix the problem, something is forcing officejs.hoxhunt.com to be displayed as Intranet site instead of Internet site. Intranet sites are rendered in Compatibility View by default.

B. Make sure sites that bypass proxy server are not considered as Intranet sites:

Go to Control Panel and open Internet Options.
Select Security > Local Intranet > Sites.
Uncheck Automatically detect intranet network.
Uncheck Include all sites that bypass the proxy server.
Restart Outlook and try again.

If this doesn't fix the problem, make sure you have the following patch installed:

https://support.microsoft.com/en-us/help/4012633/intranet-sites-include-all-sites-that-bypass-the-proxy-server-policy-s

If this doesn't fix the problem, it's time to reset LAN settings.

C. Reset LAN settings:

Go to Control Panel and open Internet Options.
Select Connections > LAN Settings.
Uncheck Automatically detect settings under Local Area Network Settings.
Restart Outlook and try again.

NOTE: If issues still persists, please contact your IT team to resolve the issue. Compatibility View might be enforced for all IE11/Edge sessions in Group Policy or by a VPN/proxy client.

Read more about Document Modes here: https://docs.microsoft.com/en-us/troubleshoot/browsers/ie-document-modes-faq
Read more about Compatibility view triggering on Trusted Sites here: https://docs.microsoft.com/en-us/troubleshoot/browsers/compatibility-view-for-trusted-sites

SCENARIO #2 - Windows and Mac users: after clicking Hoxhunt button, task pane stays blank.

Side pane is not loading any content and stays blank.

Action: Try with a different network configuration (VPN/Proxy disabled, etc.). If issue persists, please contact Hoxhunt Support for assistance.

SCENARIO #3 - Windows and Mac users: after clicking Hoxhunt button, task pane's loading animation never ends.

This issue can be caused by a firewall which prevents access to Hoxhunt services. Please make sure you have allowed inbound and outbound traffic for *.hoxhunt.com.

Please perform Basic connectivity checks (for signed-in users only).
Please run Hoxhunt's embedded debugger (for signed-in users only).
In some rare cases, the solution is to create a new Outlook profile.

SCENARIO #4 - Android and iOS users: after clicking Hoxhunt button, task pane's loading animation never ends.

Android: clear Application cache for Outlook app from Android System settings.
iOS: remove Outlook App and re-install it.

Pop-up window related issues

Result pop-up window doesn't load properly

SCENARIO #1 - Windows users: Empty pop-up window

Explanation: Task pane content is loaded from game.hoxhunt.com and rendered by either Internet Explorer or Edge. Something is forcing game.hoxhunt.com to be displayed in Compatibility View. Hoxhunt doesn't work in Compatibility View.

A. Turn off Compatibility View:

Open Internet Explorer.
Select Tools (gear icon) > Compatibility View Settings.
Under Websites you've added to Compatibility View field, remove any sites containing "hoxhunt.com".
Uncheck Display Intranet sites in Compatibility View.
Restart Outlook and try again.

B. Make sure sites that bypass proxy server are not considered as Intranet sites:

Open Internet Explorer.
Select Tools (gear icon) > Internet Options > Security > Local Intranet > Sites.
Uncheck Automatically detect intranet network.
Uncheck Include all sites that bypass the proxy server.
Restart Outlook and try again.

NOTE: If you are using Zscaler proxy and the above doesn't solve the problem, please contact Hoxhunt for further assistance.

SCENARIO #2 - pop-up window loading animation that never ends

A. This is often temporary issue or caused by a caching issue. To resolve this issue, please try one of the following:

Refresh the pop up window by pressing F5 or Ctrl+R (Command+R on a Mac).
Restart Outlook.
Check your internet connection (Wifi, VPN) and try reporting again.
If the issue continues, please reach out to Hoxhunt support.

B. If the issue persists, something is preventing the page from loading. Depending on your Outlook version, you can use Inspect feature of the embedded web browser to troubleshoot the root cause.

Right-click on the loading indicator and choose Inspect. DevTools will open.
Switch to Console tab.
Reload the page by typing location.reload() to the command line at the bottom of the Console view.
Observe any errors (in red). Provide the information to Hoxhunt Support.

If the above method of accessing Inspect isn't available, your Hoxhunt add-in is using an older web browser. Please check the articles below on how to debug with your web browser's DevTools:

SCENARIO #3 - pop-up window doesn't open

A. If the pop-up window doesn't open in Web Outlook, make sure your web browser's pop-up blocker in is not enabled for *.hoxhunt.com addresses.

B. If you are running Outlook for Windows 2016 earlier than version 16.0.4390.1000, displayDialogAsync command is not supported. Please update to a more recent version of Outlook.

C. If you are running Outlook for Windows 2016 for Windows version 16.0.4549.1000, you may be missing Office API due to incomplete update. Please refer to this article. To solve the issue, please update to a more recent version of Outlook.

Error dialog windows

Error: You cannot perform this action. Add-ins are not supported in this folder.

You cannot perform this action. Add-ins are not supported in this folder.

You cannot perform this action. This add-in scenario is not supported in this folder.

Explanation #1:

This error can occur when you try to report an email from a group mailbox or a shared mailbox, and your mailbox is hosted in an on-premise Exchange Server.

Reporting emails from shared mailboxes is not supported by Microsoft when running on-premise Exchange Server.

Explanation #2:

Outlook add-ins don't work in Junk folder when running MSI version of Outlook client. To fix the situation, please uninstall MSI version Office and re-install Click-to-Run version of Office.

Alternatively, please use Outlook on the Web to report emails in your Junk folder, or move the email back to your Inbox.

More information: https://answers.microsoft.com/en-us/msoffice/forum/all/report-message-add-in-not-working-in-junk-email/32826659-82c3-44c6-884c-c750f2fdb41a

Error: You cannot perform this action. Permissions to this message is restricted.

Explanation:

This error can occur when you try to report an email that is encrypted with a digital signature. You can often distinguish a digitally signed email from the following symbol:

Microsoft has limited Outlook add-ins from interacting with certain encrypted emails that impose restrictions on the email (do not copy contents, read-only, do not forward, etc.)

Please read up-to-date information about restricted mail items: https://docs.microsoft.com/en-us/office/dev/add-ins/outlook/outlook-add-ins-overview#mailbox-items-available-to-add-ins

Error: You can’t use this add-in along with some of your COM add-ins. To continue, please try turning off your COM add-ins individually.

You can’t use this add-in along with some of your COM add-ins. To continue, please try turning off your COM add-ins individually.

Explanation:

This is a rare error that is widely undocumented and not completely understood. It is believed to occur with email messages that contain Forms elements. These embedded Forms elements may trigger an existing COM add-in to activate on the email (see screenshot below), thus preventing other add-ins from interacting with the email. It is also possible that an existing COM add-in triggers based on the email's contents and adds a Forms page to the email message.

Figure 1: MS Exchange COM add-in has triggered on a voicemail email by adding additional controls (Forms element) to the email.

Workaround:

There are no verified workarounds for this error. However, you can try to disable the corresponding COM add-in, restart Outlook and then re-try Hoxhunt button with the email.

Further information:

https://www.reddit.com/r/Office365/comments/ish5ss/addin_issues/

https://githubmemory.com/repo/stephenegriffin/MHA/issues/241

Additional troubleshooting resources

Please see MS article: Troubleshoot user errors with Office Add-ins

Questions or further issues?

If you need any additional help, please don't hesitate to reach out to Hoxhunt Support at support@hoxhunt.com

Problems with Hoxhunt Office add-in for Outlook?