All Products
Search
Document Center

Object Storage Service:0048-00000002

Last Updated:Sep 21, 2026

Problem description

When you use a browser to access an object through an Object Storage Service (OSS) acceleration endpoint, the object may be downloaded directly instead of being previewed.

Causes

This occurs for buckets on which transfer acceleration was enabled after 00:00 on December 31, 2020. When you use an OSS acceleration endpoint to access an object whose name ends with .htm or .html, or whose Content-Type is text/html, OSS adds the following two headers to the response:

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

In a standard browser, the Content-Disposition: attachment header triggers a download instead of a preview.

Sample questions

For example, a bucket has transfer acceleration enabled after 00:00 on December 31, 2020, and contains an object named index.html. When you use a browser to access this object using the OSS acceleration endpoint, OSS adds the two headers to the response. The browser then downloads the object instead of previewing it because of the Content-Disposition: attachment header.

GET /index.html HTTP/1.1
HTTP/1.1 200 OK
Content-Disposition: attachment
x-oss-force-download: true

Solution

If you do not want OSS to return the headers that force a download, you can access the object using a custom domain name. For more information, see Map a custom domain name.