Configuring Object Metadata

OBS supports the configuration of object metadata.


You have already been granted the read permission on objects.


  1. Log in to OBS Console.
  2. In the bucket list, select the bucket for which you want to configure object metadata. In the navigation tree on the left, click Object.
  3. Click the arrow to the left of the object name and click Metadata.
  4. Click Add, as shown in Figure 1. Enter the metadata information based on your needs.

    Figure 1 Adding metadata
    OBS supports three types of metadata.
    Table 1 Supported types of metadata




    Provides a default file name for the object that is being requested. When an object is being downloaded or accessed, the file with the default file name is directly displayed in the browser or a download dialog box is displayed if the file is being accessed.

    For example, select ContentDisposition as the metadata name and enter attachment;filename="testfile.xls" as the metadata value for an object. If you access the object through a link, a dialog box is directly displayed for downloading objects, and the object name is changed to testfile.xls.


    Specifies the language of the object content.

    For example, select ContentLanguage as the metadata name and enter en-us as the metadata value for an object. If you access the object, the object content is displayed in English by default.


    Redirects an object to another object or an external URL. The redirection function is implemented using static website hosting.

    For example, you can perform the following operations to implement object redirection:

    1. Set metadata of object testobject.txt in the root directory of bucket testbucket. Select WebsiteRedirectLocation for Name and enter for Value.

      OBS only supports redirection for objects in the root directory of a bucket.

    2. Select testbucket. Choose Static Website Hosting > Static Website Hosting to set object testobject.txt as the default homepage of static website hosting.
    3. If you access object testobject.txt using the Endpoint on the Static Website Hosting page, the access request is redirected to

  5. Click Save.

Follow-up Procedure

Delete or edit metadata as needed.