Nuxeo Server

Downloading Files

This page is scheduled for review and update. Check back soon for updated content!

This page describes the logic for building the correct URL to download a file stored on a Nuxeo Document.

The structure of a download URL is made of:

  • The server URL: http://127.0.0.1:8080/nuxeo
  • The download servlet: nxfile (note that nxbigfile is also accepted for compatibility with older versions)
  • The repository name and document id: default/776c8640-7f19-4cf3-b4ff-546ea1d3d496
  • An optional file designator, either using a blobholder index, or an explicit blob property name (blobholder:0, blobholder:1, file:content, files:files/0/file, etc.)
  • An optional filename, to force the name under which you want the file to be downloaded
  • An optional ?inline=true parameter to force the download to be made with Content-Disposition: inline, which means that the content will be displayed in the browser (if possible) instead of being download.

Here are some examples:

  • The main file of the document: http://127.0.0.1:8080/nuxeo/nxfile/default/776c8640-7f19-4cf3-b4ff-546ea1d3d496
  • The main file of the document with a different name: http://127.0.0.1:8080/nuxeo/nxfile/default/776c8640-7f19-4cf3-b4ff-546ea1d3d496/blobholder:0/mydocument.pdf
  • An attached file of the document: http://127.0.0.1:8080/nuxeo/nxfile/default/776c8640-7f19-4cf3-b4ff-546ea1d3d496/blobholder:1
  • A file stored in the given property: http://127.0.0.1:8080/nuxeo/nxfile/default/776c8640-7f19-4cf3-b4ff-546ea1d3d496/myschema:content
  • A file stored in the given complex property, downloaded with a specific filename: http://127.0.0.1:8080/nuxeo/nxfile/default/776c8640-7f19-4cf3-b4ff-546ea1d3d496/files:files/0/file/myimage.png
  • The main file of the document inside the browser instead of being downloaded: http://127.0.0.1:8080/nuxeo/nxfile/default/776c8640-7f19-4cf3-b4ff-546ea1d3d496?inline=true

Other Documentation About URLs
 
2 months ago Loubna Benzaama Fix Showcase Content add-on doc
2 years ago Solen Guitter 9
3 years ago Florent Guillaume 8
4 years ago Solen Guitter 7 | JSF only content was moved on page URLs for Files
4 years ago Solen Guitter 6
5 years ago Vincent Dutat 5
5 years ago Solen Guitter 4
5 years ago Alain Escaffre 3
5 years ago Solen Guitter 2
5 years ago Alain Escaffre 1
History: Created by Alain Escaffre

We'd love to hear your thoughts!

All fields required