Dropbox Production Review Documentation


General Info


What does the add-in do?

It allows people to add files from cloud storage providers (ex: Dropbox) as attachments to their e-mails.

Where do people download the add-in?

It's developed as an Office Web add-in. People either browse it on Office Store or download it from their Outlook.com / Outook mail clients. (Images below to show the flow)

How does it use Dropbox API?

It accesses user's files through OAuth and using Office.JS attaches them to the email. No permissions are changed on the items.

Does it have a dedicated website?

It's support and privacy documentation are hosted on oattach.armhil.io and the actual web add-in is running on heroku. It currently uses the Office Store page as the main page. It doesn't have a dedicated website since you can only download it from Office Add-in Store.

Testing details for Dropbox Review


An email test account as well as a Dropbox account should have been provided to you as part of the submission. If the email sign-in doesn't work (given that this is an e-mail add-in and due to location security checks sign-in might have problems) any outlook.com account should have this functionality. There are detailed instructions below for installing the addin.
After signing in using the outlook.com account details that was provided, you can follow these steps to test the addin.

  • Click on new email and open the compose form. (The add-in is already installed for you)
  • Click on the add-in icon (bottom-right of the compose form) to activate it, and the add-in should appear next to your form
  • Click on the "Connect" button in Dropbox section to activate the provider. It will ask you whether to save your details or not. Choose your preference.
  • Sign in to your Dropbox account using the your credentials. You will get a test Dropbox account to connect, however I haven't given the permissions before to make sure add-in numbers are not inflated. Once signed in, the app should start working immediately, display a Dropbox icon at the top.
  • Click on the icon to see the list of your folders and files. Upon clicking any file, it should get attached to your e-mail.

Installation details (in case sign-in is having problems)


Please note that this is not a requirement as long as you're using an account that was provided to you. If the account doesn't work, the regular installation steps would work for you just fine. For Dropbox official review, you should have been provided with a test account. See further details below.

  • Sign-in to outlook.com using an e-mail address that you have (or get one).
  • Navigate to the cog (settings) icon on top right corner, seen below, and click "Manage integrations"

  • That should bring up the Office Add-in Store view, which you can install office add-ins.
  • You can search for "Easy file" keywords and it should bring up the "Easy file attachments" add-in. You're seeing an already-activated version below, from the my addins view.
  • When you find the add-in from the search results, click on the toggle to activate it, which will install it to your account.
  • After toggling, you can see the add-in in your e-mail compose form (as seen below).
  • Click on the add-in icon to activate it, and it should appear next to your form
  • Click on the "Connect" button in Dropbox section to activate the provider. It will ask you whether to save your details or not. Choose your preference.
  • Sign in to your Dropbox account using the your credentials. Once signed in, the app should start working immediately, display a Dropbox icon at the top.
  • Click on the icon to see the list of your folders and files. Upon clicking any file, it should get attached to your e-mail.