All Products
Search
Document Center

Object Storage Service:0048-00000110

Last Updated:Mar 19, 2026

Problem description

When you use an Object Storage Service (OSS) acceleration endpoint to access an object from a browser, the browser downloads the object instead of displaying it.

Causes

For buckets with transfer acceleration enabled after 12:00:00 on January 14, 2021, OSS adds the following headers to responses served through the acceleration endpoint:

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

The Content-Disposition: attachment header instructs the browser to download the response as a file instead of previewing it.

Examples

The following example shows a request and response for an object named test in an affected bucket. Both headers are present, which causes 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

Access the object through a custom domain name instead of the acceleration endpoint. For setup instructions, see Map custom domain names.

References