Troubleshooting the HubSpot Sales Outlook desktop add-in and Office 365 add-in

Last updated: April 18, 2018

Available For:

Marketing: N/A
Sales: Free, Starter, Professional
Service: N/A

Below are troubleshooting steps to resolve common issues with the HubSpot Sales Outlook desktop add-in and the Office 365 add-in: 

 

Troubleshooting the HubSpot Sales Outlook desktop add-in

Before trying any of the steps below, make sure you're using the most up-to-date version of the desktop add-in. HubSpot Sales will automatically prompt you to update when Outlook restarts and a newer version is available. You can force a check for updates by shutting down Outlook and reopening it.     

Alternatively, if you're not seeing the add-in at all in Outlook, check out this article.

The information below covers issues with the Outlook desktop add-in pertaining to updating, tracking and notifications, and obtaining debug logs:

Update the add-in 

Before troubleshooting, make sure you have the most recent version of the add-in. Any recent version of HubSpot Sales for Outlook will support automatic updating, although there are some instances where you may want to manually trigger an update.

First, check which version number is in use to determine if auto-updates are possible.

  • In your Outlook inbox, click HubSpot Sales in the ribbon, then select Settings.
  • In the dialog box that appears, check your Plugin Version and take the steps below:

If the version number is 2.0.3 or above

You are on a version of the HubSpot Sales Outlook add-in that supports automatic updates. To update the add-in, simply close and re-open Outlook. If an update is available, it will be applied automatically.

If the version number is 1.4.1.184 or below

You are on an older version of the HubSpot Sales Outlook add-in that does not support automatic updates. To update the add-in, you will need to uninstall the add-in and install the updated version:

  • Uninstall the HubSpot Sales Outlook add-in.
  • Install the latest version of the HubSpot Sales Outlook add-in. 

 

Tracking & notifications

Follow the steps below if your emails are not tracking or if you're not receiving open notifications.

Emails are not tracking

After sending a test email to hello@getsidekick.com, you may receive a response that your email was not tracked. Try the troubleshooting steps below to address this:

  • Ensure that HubSpot Sales for Windows is installed and enabled. 
    • Once the tray app is installed, right-click the HubSpot sprocket icon in the tray menu in the bottom right-hand corner of your PC. 
    • If the app is not enabled, the icon will be grayed out. After right-clicking, select Enable Notifications

  • Before sending your email, ensure that the Track email box is checked.
    • If the box was not checked, the tracking pixel that HubSpot Sales uses to track email opens will not be inserted in the email.
    • To check if the tracking pixel was inserted in a sent email, access the source content of the email and look for code similar to the following:

                    <img src=3D"http://t.sidekickopen69.com/e1t/o/5/f18dQhb0S7ks8dDMPbW2n0x6l2B= 
                    9gXrN7sKj6v5dlMTVfn3cs3M2y_-W2B89RP1pctGFW8mdf1T1k1H6H0?si=3D56803726671216=
                    64&amp;pi=3D01cd79e8-c6c3-455d-d1aa-5175f2b770de&amp;ti=3Dundefined" style=
                    =3D"display:none!important" height=3D"1" width=3D"1">

  • Emails sent in Plain Text mode cannot be tracked. If you see that emails are sending in Plain Text, switch to HTML mode:
    • Compose a new email in Outlook.
    • Under the Message Options tab in the Format group, click HTML or Rich Text.
  • Try uninstalling and then re-installing the add-in.

After walking through these steps, send another test tracked email to hello@getsidekick.com to receive a notification. 

Notifications are not appearing

  • Real-time HubSpot Sales notifications are sent through Google Chrome or the HubSpot Sales for Windows tray app. If you are sending tracked emails using the Outlook desktop add-in and are not receiving real-time HubSpot Sales notifications, make sure your Chrome browser is running in the background or that you have the HubSpot Sales for Windows tray app enabled.
  • If you have the Windows tray app installed as well as the Chrome extension, the tray app will not display notifications. HubSpot Sales will rely on the Chrome extension to do this instead.
  • Ensure that you are logged into the correct HubSpot Sales account when sending tracked emails using the desktop add-in. If you're logged into the incorrect HubSpot Sales account in Chrome, your Outlook inbox needs to be reconfigured to the correct account. Check out this article for instructions on this process.

Please note: real-time notifications are not available if you are using the HubSpot Sales Office 365 add-in. Instead, you'll only see activity in your HubSpot activity feed under Sales Tools > Activity Feed.

Debug logs

When you're working with HubSpot Support to troubleshoot the desktop add-in, you'll occasionally be asked to provide debug logs. When you have the extension installed in Outlook, it will store information in report logs on your computer. These logs are saved each day the extension is used, and your file names refer to the usage date. If your extension isn't functioning as expected, these logs help the support team take a deeper look into what's happening with the add-in on your computer. 

There are two ways to gather debug logs: from your PC's Start Menu and from your Outlook account.  

Access my debug logs from your PC's Start Menu

  • On your PC, click your Start Menu
  • Paste this file path into the search bar at the bottom of your menu and press Enter on your keyboard: C:\Users\%username%\AppData\Roaming\Sidekick\Logs  (be sure to replace %username% with the username you use to sign into your PC).    
  • A window will open with your debug logs. Add these logs as attachments to your support ticket.


Access debug logs from your Outlook account

  • In Outlook, click HubSpot Sales in the main ribbon and select Settings

  • In the dialog box, click Help > Send Logs.

  • This will open an email composition window with a HubSpot Outlook distro email in the To field. Replace this with the email address of the support specialist you're working with and click Send

 

Troubleshooting the HubSpot Sales Office 365 add-in

The information below covers issues with the Office 365 add-in: 

 

The add-in is grayed out in Outlook desktop on PC

If you're using the Office 365 add-in in Outlook desktop on a PC, you might experience the add-in being grayed out/disabled.

If the Office 365 add-in is grayed out in both your main Outlook ribbon and within your compose window,
there's an issue with your Outlook program itself. Add-ins can randomly become disabled. Try closing Outlook and reopening it.

grayed-out-add-in

If the add-in is enabled in your main Outlook ribbon but grayed out in your Outlook compose window, try the steps below:  

grayed-out-compose-window

  • If your email is not being encrypted, try uninstalling and reinstalling Outlook:
    • Go to your PC's Start Menu. Search for and select Programs and Features.
    • Click the Outlook program in the list.
    • Click Change (next to Uninstall).
    • When this process starts, you’ll be asked to select the Repair mode. Select Online Repair from the dialog box.

Emails are not being tracked

There are a few reasons your email may not have been tracked when using the Office 365 add-in:

  • Your inbox has not been connected. The HubSpot Sales Office 365 add-in requires a connected inbox
  • The add-in wasn't open when the email was sent. To open the add-in:
    • If you're using an Outlook desktop account on a PC or Mac, click Sales Tools in the Outlook ribbon at the top of the compose window. If the Sales Tools icon is grayed out, restart Outlook. 
    • If you're using an Outlook on the web or Outlook.com account, compose a new email and click the HubSpot sprocket icon in the bottom right-hand corner of the email composition window.
  • The Track email opens box was not checked when the email was sent. You'll need to check the box for each email you'd like to track. 

Was this article helpful?

Previous article:

Next article: