Media2URL Logo
GuidesDropboxFile Links

Dropbox Direct Link: How dl=0, dl=1 and raw=1 Work

Sourabha Sahu
Sourabha SahuCo-founder – Development & Product Systems
July 10, 2026
6 min read
Dropbox Direct Link: How dl=0, dl=1 and raw=1 Work

Use dl=0 when you want the normal Dropbox preview.

Use dl=1 when you want the browser to download the file.

Use raw=1 when you want Dropbox to render supported content in the browser. Dropbox states that the raw version uses an HTTP redirect, so the application must follow that redirect.

These parameters change how the Dropbox shared link behaves. They do not turn Dropbox into a complete media-hosting platform.

A Dropbox shared URL may end like this:

?dl=0

This opens the normal Dropbox preview page.

For example:

https://www.dropbox.com/scl/fi/example/photo.jpg?rlkey=example&dl=0

This is suitable when you want the recipient to view the file through Dropbox.

It is not always suitable inside an HTML image field because the URL may initially return a Dropbox page.

Force the file to download with dl=1

Change:

dl=0

to:

dl=1

Example:

https://www.dropbox.com/scl/fi/example/report.pdf?rlkey=example&dl=1

Dropbox documents dl=1 as the option for forcing the browser to download the shared file.

Use this for:

  • Download buttons
  • ZIP archives
  • Documents meant to be saved
  • Software or resource files

It is not suitable when you want the file to display directly inside the page.

Render supported content with raw=1

Change the parameter to:

raw=1

Example:

https://www.dropbox.com/scl/fi/example/photo.jpg?rlkey=example&raw=1

Dropbox says this asks the browser to render supported file content.

Technical Note: The request uses a redirect before the file is served. An application or API client that does not follow redirects will fail to fetch the image even when the link loads inside a normal browser.

Quick parameter comparison

ParameterMain behaviour
dl=0
Opens the Dropbox preview
dl=1
Forces the file to download
raw=1
Renders supported content after a redirect

Do not place more than one of these final behaviour parameters in the same URL.

Keep required values such as rlkey unchanged.

Use raw=1 when you need the browser to display a supported image through Dropbox.

For example:

<img
  src="https://www.dropbox.com/scl/fi/example/photo.jpg?rlkey=example&raw=1"
  alt="Photo"
>

Test it in the actual website or application.

The browser may follow the redirect correctly. Some APIs, import tools, or third-party platforms may not.

Why the image may still fail

A correct raw=1 parameter does not guarantee that the file will remain available.

The link can fail when:

  • Public access is removed
  • The file is deleted or moved
  • Dropbox interrupts sharing
  • The application refuses redirects

Dropbox says sharing can be interrupted because of malware, copyright complaints, bandwidth use, or too many downloads in a day.

Dropbox access controls

Dropbox supports sharing permissions such as anyone-with-link access and team-only access. Eligible plans can also provide additional link controls.

A raw parameter does not bypass those permissions.

When the file requires sign-in or the owner has removed public access, changing dl=0 to raw=1 will not make it public.

Can Dropbox host an HTML website?

No. Dropbox’s direct-link guidance says shared links do not render HTML content as a hosted webpage.

You can share an HTML file for download or preview. You should not use a Dropbox shared link as normal website hosting.

Dropbox is still useful for collaboration

Dropbox is suitable when files need:

  • Synchronisation across devices
  • Shared folders
  • Team access
  • General cloud storage

A direct media host is suitable when the public URL itself needs ongoing controls.

The same business may use Dropbox for internal source files and Media2URL for public delivery copies.

Check the URL before using it

Paste the Dropbox URL into Link Doctor.

The result can explain:

CheckPossible result
Parameter
Preview, download, or raw
First response
Dropbox HTML or redirect
Final content
Image, PDF, audio, or another file
Redirect count
Number of addresses followed
Public access
Available or restricted
Content type
What the final server returns

This is useful when the link works in your browser but fails in an app.

Importing a Dropbox file into Media2URL

  • Paste the public Dropbox URL into Media2URL Migration Hub
  • The resolver automatically maps the rlkey and redirect paths
  • Media2URL downloads the raw bytes, uploads it to R2 CDN, and creates a permanent, fast direct link

The resolver adjusts the public delivery request and follows the supported redirect before importing the file.

It does not bypass:

  • Password protection
  • Account permissions
  • Team-only access
  • Removed public sharing

The user must own the file or have permission to host a separate copy.

DropboxMedia2URL
One shared link with behaviour parameters
Separate direct, share, and download URLs
Raw file may involve redirects
Direct hosted route
Built for storage and collaboration
Built for link delivery and control
Dropbox permissions
File-level Media2URL settings
File history inside Dropbox workflow
Version history attached to hosted link
Platform-level bandwidth rules
Optional per-file budget

A practical document example

A company shares a catalogue through Dropbox:

https://www.dropbox.com/scl/fi/example/catalogue.pdf?rlkey=example&dl=0

Visitors see a Dropbox preview.

Changing it to dl=1 starts a download.

Changing it to raw=1 asks the browser to render the PDF after a redirect.

If the catalogue address is already printed inside a QR code and the file needs regular updates, a managed Media2URL link may provide a different workflow. The owner can replace the active PDF while keeping the published Media2URL address.

Final answer

Use dl=0 for Dropbox preview, dl=1 for forced download, and raw=1 for browser rendering of supported content.

Remember that raw=1 still uses a Dropbox redirect. The shared file must remain public and available.

Use Dropbox when storage and collaboration are the main requirements. Use a dedicated direct-link host when you need a managed public media URL without editing Dropbox query parameters.

Frequently Asked Questions

What does dl=1 mean in a Dropbox link?

It asks the browser to download the file instead of displaying the normal Dropbox preview.

What does raw=1 mean?

It asks Dropbox to render supported content in the browser. Dropbox says the request causes an HTTP redirect.

Can Dropbox raw links host an HTML website?

Dropbox says shared links do not render HTML content as a webpage.

Does Dropbox support passwords and expiry?

Eligible paid plans support passwords and expiry dates for shared links.

Can Media2URL import a password-protected Dropbox file?

Not by bypassing the password. The file must be publicly accessible or uploaded by its owner through an authorised method.