Dropbox Embedder Moves from Preview to General Availability

Dropbox has officially released the Embedder, graduating the pre-built component from the preview stage it entered several months ago. The Embedder is now a fully supported production tool for developers who want to display Dropbox content on their own surfaces, joining the existing Chooser and Saver components in Dropbox's pre-built toolkit. These components give developers access to rich Dropbox API functionality from small amounts of code.

Improvements Over the Preview Build

The general availability release incorporates feedback gathered from the developer community during the preview period. Dropbox prioritized the requests that would deliver the most impact and has shipped a range of bug fixes along with more informative error states. A notable addition is the Dropbox.unmount() method, which provides a cleaner way to remove an embedded instance from a page.

Developers also asked for configuration control, so the Embedder now supports an options object passed into the Dropbox.embed() function. With this options object, users can:

  • Set the zoom mode for embedded files
  • Set the default view for embedded folders
  • Change the size of the folder header

The visual presentation of the Embedder has also been refreshed as part of the release, tidying up the overall aesthetics from the earlier preview design.

Screenshot of old version of embedded folder
[Old] Embedded folder
Screenshot of new version of embedded folder
[New] Embedded folder

Embedder in the Wild

During its preview phase, the Embedder was adopted by a variety of organizations. Three integrations stand out as particularly representative of its range.

Atlassian built a Dropbox Smart Link on top of the Embedder, letting Jira and Confluence users access Dropbox content directly from the editor. The rich file previews display contextual metadata and actions, reducing the need to switch between applications. A full-stack engineer on the Jira team reported a smooth integration experience and expressed confidence that the feature would deepen user engagement with content.

Sheetgo File Previewer

Sheetgo, a no-code automation platform for spreadsheet-driven workflows, uses the Embedder to show users previews of spreadsheets stored in Dropbox before they build custom automations. A product manager at Sheetgo described the capability as essential to a smooth product experience.

University of Milan COVID Document Center

A research center at the University of Milan, which also publishes the online journal CERIDAP, created a section on its website devoted to official COVID-19 documents issued by Italian state and local authorities. The site's developer used the Embedder to display and distribute those acts, praising the ease of implementation. The solo developer reported it took only minutes to go live, dropping the HTML snippet into a WordPress Gutenberg block with no further work required.

Screenshot of the Embedder being used by CERIDAP to distribute pandemic resources
The Embedder being used by CERIDAP to distribute pandemic resources

Building with the Embedder

As of the time of this announcement, the Embedder supports a range of multi-page documents and images. Future releases may extend support to additional file types; the Embedder documentation contains the current list of supported files. Feedback on the component's direction continues to be welcome through the Dropbox developer forum, and developers can reach out via the support request form or on Twitter at @dropboxapi.