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.
The normal Dropbox sharing link
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
| Parameter | Main 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.
Which Dropbox link should you use for an image?
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:
| Check | Possible 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.
Dropbox link compared with Media2URL output
| Dropbox | Media2URL |
|---|---|
| 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.

