MessageAttributeValue - Amazon Simple Queue Service
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).


The user-specified message attribute value. For string data types, the Value attribute has the same restrictions on the content as the message body. For more information, see SendMessage.

Name, type, value and the message body must not be empty or null. All parts of the message attribute, including Name, Type, and Value, are part of the message size restriction (256 KiB or 262,144 bytes).



Amazon SQS supports the following logical data types: String, Number, and Binary. For the Number data type, you must use StringValue.

You can also append custom labels. For more information, see Amazon SQS Message Attributes in the Amazon SQS Developer Guide.

Type: String

Required: Yes


Not implemented. Reserved for future use.

Type: Array of Base64-encoded binary data objects

Required: No


Binary type attributes can store any binary data, such as compressed data, encrypted data, or images.

Type: Base64-encoded binary data object

Required: No


Not implemented. Reserved for future use.

Type: Array of strings

Required: No


Strings are Unicode with UTF-8 binary encoding. For a list of code values, see ASCII Printable Characters.

Type: String

Required: No

See Also

For more information about using this API in one of the language-specific Amazon SDKs, see the following: