Amazon Simple Storage Service
Console User Guide (API Version 2006-03-01)

Editing Object Metadata


This is the User Guide for the old Amazon S3 console. If you are looking for the User Guide for the new Amazon S3 console, see Welcome to the New Amazon S3 Console User Guide.  

Each object in Amazon S3 has a set of key-value pairs that represents its metadata. There are two types of metadata:

  • System metadata – Sometimes processed by Amazon S3, e.g., Content-Type, and Content-Length.

  • User metadata – Never processed by Amazon S3.

    User metadata is stored with the object and returned with it.

The maximum size for user metadata is 2 KB, and both the keys and their values must conform to US-ASCII standards.

This section explains how to use the console to add and remove the metadata associated with an object.

To edit the metadata of an object

  1. Sign in to the AWS Management Console and open the Amazon S3 console at

  2. Click the object whose metadata you want to edit, and then click Metadata.

  3. Do one of the following:

    To... Do This...
    Add metadata
    1. Click Add more metadata.

    2. In the Key box, click one of the available keys, or type a new one, starting with x-amz-meta- (for example, x-amz-meta-<name>).

    3. In the corresponding Value box, click an entry in the list, if available, or type a value.

    Delete metadata
    1. Click the key-value pair that you want to remove.

    2. Click Remove selected metadata, or click the "x" on the line of the key-value pair that you want to remove.


    User-defined metadata names must begin with "x-amz-meta-", otherwise Amazon S3 will not set the key value pair as you define it.

  4. Click Save.