Troubleshooting the Spekit Add-In for Outlook

• The Add-In isn’t showing up in Outlook

  • Ensure the Add-In is installed via one of the supported methods:

    • Microsoft AppSource (Outlook Web or Desktop)

    • Outlook Desktop Add-Ins (Windows or Mac)

    • Mass deployment by your IT team (recommended)

  • Restart Outlook or your browser.

  • Confirm your Outlook version is supported (Microsoft 365 version later than 16.0.11629 on Windows 10, or supported Mac versions).

• Installation prompts or errors

  • Clear your browser cache or restart Outlook.

  • Ensure you have proper permissions to install Add-Ins.

  • Contact Spekit Support if the issue persists.

Login and Account Issues

Guidance for logging in and resolving issues related to incorrect accounts, missing organizations, or failed authentication.

• Unable to log in

  • Open or compose a new email before clicking the Spekit icon.

  • Supported login methods:

    • Single Sign-On (SSO)

    • Salesforce

    • Salesforce Sandbox

    • Spekit Username & Password

  • Verify that your account is active and correctly associated with your organization.

• Wrong account or organization displayed

  • Check Profile and Spekit Org in the Add-In.

  • Log out and log back in if needed.

  • Contact your Spekit Admin if your account is not linked properly.

Content Display and Access Issues

Addresses problems with viewing, inserting, or downloading Speks and files within Outlook, and offers guidance on formatting compatibility.

• Speks or Files not showing

  • Verify permissions for the content (team or organization level).

  • Confirm that files are synced and accessible (e.g., Google Drive or SharePoint permissions).

  • Refresh the Add-In or restart Outlook.

• Content formatting not copying correctly

  • Outlook may not support some formatting, such as:

    • Tables with colored highlights

    • Images or complex layouts

  • Simplify formatting for better compatibility when inserting into emails.

• Downloading Files Not Working

  • Downloading is only supported on Windows.

  • Click the Download icon next to the file in the Add-In.

Outlook Issues on Mac and Windows 

There are some known limitations with Outlook on Mac and Windows. If you're experiencing an issue, check below to see if it's a known limitation.

Mac: 

• Users won't be able to download files on both the desktop and web versions.
• The header may not be visible.
• Text on the recommendation cards might be overlapped on Mac desktops.
• Images inside the content may not load on Mac desktops.
• The Spekit plug-in may not show when 'Chrome Dev Tools' is opened, although this primarily affects certain Mac versions and may not impact the end-user.

Windows: 

• There are limitations with rendering images in Legacy Outlook versions.

Known Spekit Add-In for Outlook Limitations

When using the "Insert into Email" feature in the Spekit Add-In for Outlook, there are certain limitations to be aware of, particularly related to how Outlook handles content formatting.

Known Behavior:

If the Spek contains content that is incompatible with Outlook, only the text will be copied into the email body, and any other elements (such as tables or highlighted text) may not appear as intended.

Example Scenarios:

• Incompatible Formatting: If a table contains neon green highlighted text, the table and the highlighted text will not copy over. Only the text itself will be inserted into the email.
• Compatible Formatting: If the table and text are highlighted in a more generic color, such as blue, both the table and the highlighted text will copy over successfully.

This issue is related to how Outlook handles certain content types, not the Spekit Add-In for Outlook. For optimal results, adjust the content formatting when using this feature.

Mass Deployment Issues

Provides guidance on deploying the Spekit Add-In to multiple users, including troubleshooting delayed deployments and permission issues.

• Deployment delays or Add-In not appearing

  • Deployment may take up to 24 hours.

  • Users must restart Outlook after deployment.

  • Ensure deployment method and permissions are correctly set.

  • Confirm that Outlook version is compatible with the Add-In.

Best Practices and Tips

Helpful recommendations to optimize the Spekit Add-In experience, including workflow tips and when to use the Chrome Extension for full functionality.

• Pin the Add-In to the Outlook ribbon for easy access.

• Open Spekit after starting a new email or opening an existing one.

• Regularly update Outlook to avoid compatibility issues.

• Use the Chrome Extension for full Spekit features when possible.

Support and Feedback

If you’re experiencing an issue that isn’t listed here, you have a few ways to get help:

1. Contact Spekit Support

   • Email: support@spekit.co

   • Standard Support Hours: Monday–Friday, 7:00 AM – 4:00 PM PT

   • Emergency/Outage Support: 24/7/365

2. Submit Feedback or Report Bugs via Canny

   • Log in with your Spekit account to access the Canny feedback board.

   • Explore existing posts and vote on ones that matter to you.

   • Submit new ideas or bug reports by filling out the feedback form, selecting a category, and submitting your post.

   • You’ll be notified via email about status updates (Open → Planned → In Progress → Complete).

3. Track Progress and Updates

   • Check the Roadmap for ongoing work.

   • View and subscribe for new Spekit updates on the Changelog.

If you have any questions or need further assistance, don’t hesitate to reach out to Spekit Support.