๐ Deployment Status
Add-in Manifest URLs
What you need to deploy each Draftable Office Add-in
to your Microsoft 365 tenant via the Admin Center.
Deploy every add-in from its manifest URL: click the
copy button, then paste it into the Admin Center.
Draftable Clean also needs its permissions granted once
with the admin consent link in
Step 4.
Where an add-in offers a latest manifest, prefer it over
the pinned one: it follows updates within
the same major version, so later releases reach your
users without you re-pointing the URL. Choose pinned when
you want to decide when each update reaches your users.
Each card shows the Draftable desktop version the add-in
needs. If your computers cannot run it yet, open
Older versions on the card. It appears
only where an add-in has builds that run on an earlier
desktop.
Deployment Instructions
Step 1: Access Microsoft 365 Admin Center
- Navigate to the Microsoft 365 Admin Center
- Sign in with your administrator credentials
Step 2: Navigate to Integrated Apps
- In the left-hand navigation menu, expand Settings
- Click on Integrated apps
Step 3: Add the Add-in
- Click the Get apps button at the top of the page
- Click Upload custom apps (shown as Deploy Add-in in some versions of the admin portal)
- Choose I have a URL for the manifest file
- Paste the manifest URL you copied
- Click Validate or Next to check the manifest
Step 4: Grant Draftable Clean's Permissions
- For Draftable Clean only, open the admin consent link
- Sign in as an administrator of your organization and click Accept
You grant consent once, here, on behalf of the whole organization. Individual users are never prompted.
If you decline, the add-in still installs and cleaning still works normally. Only the send-time verification is unavailable, and the task pane's status line reads
Graph off.
Classic Outlook does not use these permissions, but they keep the send-time verification on for users of New Outlook and Outlook on the web. See also Add-in works, but the send-time check is off under Troubleshooting.
- Remove the .zip deployment under Integrated apps, so only one copy is assigned
- Deploy Draftable Clean from its latest manifest URL (Step 3), then grant its permissions (Step 4)
- Changes can take up to 24 hours to reach Outlook. Until then, Send Anyway on that prompt sends the email as it is: attachments the Draftable Clean pane has already cleaned go out cleaned
Step 5: Configure Deployment Settings
- Click Next to proceed
-
Choose who should have access to the add-in:
- Everyone - Deploy to all users in your organization
- Specific users/groups - Select particular users or security groups
- Just me - Deploy only to your account (for testing)
-
Select the deployment method:
- Fixed - Add-in is automatically installed and users cannot remove it
- Available - Add-in is available for users to install from their Office apps
- Optional - Add-in is automatically installed but users can remove it
Step 6: Complete Deployment
- Review your configuration settings
- Click Deploy to finalize the deployment
- Wait for the deployment to complete (typically a few minutes)
Step 7: Verify Deployment
- Open Word, Excel, PowerPoint, or Outlook (depending on which add-in you deployed)
- Go to the Home tab (or Insert tab in older Office versions)
- Look for the Draftable section in the ribbon
- The add-in buttons should appear in the ribbon or under My Add-ins
-
For Draftable Clean, open the task pane and check
the status line at the bottom. It should read
Graph ok. If it readsGraph off, the send-time check is not running — see Troubleshooting
Additional Resources
Troubleshooting
Add-in not appearing for users?
- Wait up to 24 hours for deployment to fully propagate
- Verify users are in the correct security group (if using group-based deployment)
- Have users restart their Office applications
- Check that users have active Microsoft 365 subscriptions with Office apps
- Ensure users are signed in with their organizational account
Manifest validation failed?
- Ensure you copied the complete URL without extra spaces or line breaks
- Verify the URL is accessible from your network (not blocked by firewall or proxy)
-
Check that
dl.draftable.comis not blocked by your organization's web filter - Try accessing the URL directly in a browser to confirm it's reachable
Need to update to a new version?
- Update the Draftable desktop app on every computer first, then change the manifest URL. If an add-in gets ahead of the desktop, it stops working for those users until the desktop is updated. Each add-in's card shows the desktop version it needs
- Within a major version, the latest manifest delivers updates automatically. If a release raises the desktop version an add-in needs, we tell customers in advance
- A new major version always has a new manifest URL, so it only reaches users when you switch to it
- Deployments made from a latest manifest update themselves. Later releases within the same major version reach users with no admin action at all
- To move a pinned deployment forward, return to Integrated apps, open the Draftable add-in, choose Update and supply the new pinned manifest URL
- Users may need to restart Office apps to see the update
Add-in works, but the send-time check is off?
The add-in installs, opens and cleans attachments normally; only the server-side verification at send time is missing. In New Outlook and Outlook on the web, users are asked to confirm every send that has cleaned attachments, with a message that starts Send-time verification isn't enabled for this account. Classic Outlook never runs this check, so its users see nothing.
-
Confirm it: open the Draftable
Clean task pane and read the status line at the
bottom.
Graph okmeans the check is running;Graph offmeans it is not - Most likely cause: the permissions were never granted. Grant them with the admin consent link in Step 4
- Users must be signed into Office with the organizational account the add-in was deployed to. A personal Microsoft account cannot receive the organization's grant
Classic Outlook says Draftable Clean is unavailable on every send?
Outlook shows Draftable Clean is unavailable and can't process your email at this time, even though Draftable Clean is running and the task pane works. If Draftable Clean was deployed from the app package (.zip), replace it with the manifest URL: Already deployed Draftable Clean from the app package. Until the change reaches Outlook, Send Anyway sends the email as it is: attachments the Draftable Clean pane has already cleaned go out cleaned.
Remove or uninstall an add-in?
- Go to Integrated apps in the Admin Center
- Click on the Draftable add-in
- Select Remove or Delete
- Confirm the removal
- The add-in will be removed from users' Office apps within 24 hours