Foldr Zen Zone

Knowledge Base

Microsoft Outlook Foldr Add-In (Desktop & Web)

Foldr server update v4.23.0.16 (March 2022) includes a new Outlook Add-In feature that allows Outlook users to include files/folders from Foldr storage either as a link or individual files as an attachment.  The add-in is compatible with both desktop and web-based versions of the Outlook client on Windows and macOS.  The add-in must be added as a one-time operation via either the web or desktop Outlook app.  Once it is added, it will be available in both apps (web and desktop).

Requirements:

– The Foldr server running v4.23.0.16 or higher
– The Foldr server must be available externally
– A valid signed SSL certificate must be installed on the Foldr server.
– Sharing features must be enabled on the server to allow users to insert public or secure links
– The File Picker is enabled in Foldr Settings > Integration > File Picker (enter the server’s public URL/external hostname)

Enabling the Outlook Add-In on the Foldr Server

1.  Ensure the Foldr server’s public/external address is configured within Foldr Settings > Appliance > Network > Configuration > External Hostname.   (https://files.foldr.io is to be used as an  example in this KB article)

2.  Enable the Outlook Add-In, by browsing to Foldr Settings > Integrations > Microsoft Outlook Add-in

3.  Enable the toggle and click Save Changes

4.  Copy the metadata adddress shown in the format:

https://address-of-foldr/services/msoutlook/manifest.xml

Adding the Foldr Add-In to a single Outlook account (Web app)

Open the browser and sign into Outlook at https://outlook.office.com/mail

To add the Foldr Add-In, click New message to compose a new email

Click the Ellipsis [] button highlighted below

Click Get Add-Ins

The Add-ins for Outlook dialog will display.  Click My add-ins on the left panel

Under My add-ins, scroll down to the Custom Add-Ins section

In the pop-up menu, select Add from URL

Paste in the metadata address copied earlier in Foldr Settings  > Integrations > Microsoft Outlook Add-In

Click OK

Click Install on the following prompt

Foldr will now be shown as a custom add-in

Close the Add-Ins for Outlook dialog.

The add-in is now ready to use and will be available in both web and desktop versions of Microsoft Outlook.

Using the Outlook Add-In (web)

When composing an email, the Foldr add-in can be opened using the ellipsis […] > Foldr

The Foldr panel will appear on the right of the interface.  Where the user can select to Attach a file, create a link to a file or folder (public link) or a secure link.  A secure link allows the user to specify recipients allowed to use the link by email address.

Selecting one of the buttons in the Foldr add-in will open the Foldr web sign-in UI where the user can sign in and view the storage available to them through the Foldr file picket.  The user can browse to individual files to attach to emails or files and folders to create basic or secure links.

When creating secure links, providing the user has already populated the TO: field in the email, these will be automatically added to the External users field in the sharing UI.

Adding the Foldr Add-In to a single Outlook account (Windows desktop app)

To enable the Foldr add-in in the Outlook desktop, the process is the same as above for the web app, but the user must first click File

Then, click Manage Add-ins (bottom option)

The system default web browser will launch and the user will be prompted to sign into Office 365 if not already signed in.  After signin, the Outlook Add-ins page will be displayed and the process is the same as the Outlook web app.

Click My add-ins

Under My add-ins, scroll down to the Custom Add-Ins section

In the pop-up menu, select Add from URL

Paste in the metadata address (https://address-of-foldr/services/msoutlook/manifest.xml) copied earlier in Foldr Settings  > Integrations > Microsoft Outlook Add-In

Click OK

Click Install on the following prompt

Foldr will now be shown as a custom add-in

Close the Add-Ins for Outlook dialog.

The add-in is now ready to use and will be available in both web and desktop versions of Microsoft Outlook.

Adding the Foldr Add-In to Outlook (macOSdesktop app)

The steps to add the Outlook Add-in on macOS is the same as for Windows (above), but the Get Add-Ins menu is available on the Outlook home screen using the Ellipsis menu below.  Click Get Add-ins

The ‘Add-Ins for Outlooks’ web dialog will be displayed and the steps are then identical to Windows.

Using the Outlook Add-in (desktop)

Now the add-in is available in the desktop client, the Foldr button will be visible when composing new email messages

Clicking the button will open the Foldr add-in panel on the right of the Outlook interface.

Selecting one of the buttons in the Foldr add-in will open the web sign-in UI where the user can sign in and view the storage available to them through Foldr.  The user can browse to individual files to attach to emails or files and folders to create basic or secure links.

When creating secure links, providing the user has already populated the TO: field in the email, these will be automatically added to the External users field in the sharing UI.

Adding the Outlook app for all users (Office 365 Admin)

It is possible to add the Outlook add-in for all or selected users/groups in Office 365 so it will be available immediately without the user having to manually add it themselves.

To do this, browse to https://admin.microsoft.com and sign in with the administrative account.

Click Show All > Settings > Integrated Apps

Click Upload Custom Apps

Select ‘Provide a link to manifest file‘ and enter the URL shown in Foldr Settings > Integrations > Microsoft Outlook Add-in

Click Validate and a success message should be shown

On the next screen, choose which users/groups the app should be made available to, or select the ‘Entire organization’

A permission request summary will be shown

Click Next

A Review and finish deployment summary will be shown.

Click Finish deployment

A message will be shown informing the admin that it may take up to six hours for the Foldr app to be available in the selected users Outlook application.  Note that it may take some time to appear in Outlook.

Foldr will now be visible under the Outlook Add-in screen, under Managed apps and should appear automatically for users.  Users can initiate and use the Outlook Add-in as shown in the sections above titled ‘Using the Outlook Add-in for desktop | web’

Every journey begins with a single step

Declutter, Focus, Zone In. Repeat.

Begin your File Zen Journey