All Products
Search

This Product

    Object Storage Service:0048-00000107

    Document Center

    Object Storage Service:0048-00000107

    Last Updated:Mar 20, 2026

    Problem description

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

    Causes

    OSS adds the following two response headers when a request comes through an acceleration endpoint. This applies only to buckets where transfer acceleration was enabled after 12:00:00 on January 7, 2021.

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

    Content-Disposition: attachment instructs the browser to download the content rather than open it inline.

    Examples

    The following example shows a request and response for an object named test in a bucket that meets the trigger condition:

    GET /test HTTP/1.1

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

    Solutions

    Use a custom domain name instead of the acceleration endpoint to access the object without triggering a download. For setup instructions, see Map custom domain names.

    References