All Products
Search
Document Center

Object Storage Service:0048-00000109

Last Updated:Mar 20, 2026

Problem description

When you access an OSS object through a transfer acceleration endpoint in a browser, the browser downloads the object instead of displaying it inline.

Causes

If transfer acceleration was enabled on the bucket after 18:00:00 on January 8, 2021, OSS includes the following headers in every response returned through the acceleration endpoint:

x-oss-force-download: true
Content-Disposition: attachment

Content-Disposition: attachment instructs the browser to download the object rather than render it inline.

Examples

The following example shows a request to an object named test in a bucket for which transfer acceleration was enabled after 18:00:00 on January 8, 2021. The response includes both headers, causing the browser to download the object instead of previewing it.

GET /test HTTP/1.1

HTTP/1.1 200 OK
Content-Disposition: attachment
x-oss-force-download: true

Solutions

Use a custom domain name to access the object. OSS does not include x-oss-force-download or Content-Disposition: attachment in responses served through custom domain endpoints, so the browser renders the object inline.

For setup instructions, see Map custom domain names.

References