All Products
Search

This Product

    Object Storage Service:0048-00000112

    Document Center

    Object Storage Service:0048-00000112

    Last Updated:Mar 19, 2026

    Problem description

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

    Note

    Note: This behavior only affects buckets that had transfer acceleration enabled after 00:00:00 on February 1, 2023.

    Causes

    For affected buckets, 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 response as a file rather than render it inline.

    Examples

    The following example shows the response headers for a GET request to an affected bucket via the acceleration endpoint:

    GET /test HTTP/1.1

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

    Solutions

    To restore inline preview behavior, bind a custom domain name to your bucket and access the object through that domain instead of the acceleration endpoint.

    For setup instructions, see Map custom domain names.

    References