---
title: "Put Object Meta Data"
url: https://docs.catalyst.zoho.com/en/sdk/java/v1/cloud-scale/stratus/put-object-meta/
description: "This page lists the Java SDK method to add meta data for an object stored in the object."
last_updated: 2026-09-08T11:07:33Z
service: Cloud Scale
type: general
related_links:
  - name: "Stratus Component Help Documentation"
    url: /en/cloud-scale/help/stratus/introduction
  - name: "Object Metadata Help Documentation"
    url: /en/cloud-scale/help/stratus/objects/introduction/#metadata
  - name: "JavaScript SDK Documentation"
    url: /en/sdk/javascript/v1/cloudscale/stratus/put-object-metadata/
  - name: "Python SDK"
    url: /en/sdk/python/v1/cloud-scale/stratus/put-object-meta/
  - name: "iOS SDK"
    url: /en/sdk/ios/v2/cloud-scale/stratus/overview/
  - name: "Android SDK"
    url: /en/sdk/android/v2/cloud-scale/stratus/overview/
  - name: "Flutter SDK"
    url: /en/sdk/flutter/v2/cloud-scale/stratus/overview/
  - name: "REST API"
    url: /en/api/code-reference/cloud-scale/stratus/get-all-buckets/#GetAllBuckets
---

# Put Object Meta Data

Using the following SDK method, you can add [meta details](https://docs.catalyst.zoho.com/en/cloud-scale/help/stratus/objects/introduction/#metadata) for a particular object stored in a bucket in Stratus. The Object reference used in the below code snippet is the [component instance](https://docs.catalyst.zoho.com/en/sdk/java/v1/cloud-scale/stratus/create-object-instance/).

> **Info:** To use this SDK method, you need intialize it with **Admin** scope. You can learn more about this requirement from this [section](https://docs.catalyst.zoho.com/en/sdk/nodejs/v2/overview/#initialize-sdk-with-scopes)

The meta details will be passed as JSON key value pairs. For example, {"meta_key" : "meta_value"}

> **Note:**

* You can use alphanumeric, underscores, or whitespace characters, as well as hyphens, to write your metadata. No other special character is allowed other than the once mentioned.

* You can fetch the metadata of an object using the `HEAD` request method. In the response, the metadata will be listed in the key '`x-user-meta`'.

* The maximum size limit of characters allowed for the overall metadata is **2047** characters. The character count used to determine the size limit also includes the colon ":" special character used to define the key value pair.

#### Sample Code Snippet 

**Package Imports**

```java
import org.json.simple.JSONObject;
import java.util.HashMap;
```

```java
HashMap<String, String> objectMeta = new HashMap<>();
objectMeta.put("key1", "value1");
objectMeta.put("key2", "value2");
JSONObject res = object.putMeta(objectMeta);
System.out.println(res);
```

> **Note:** Using this method to pass new meta details without adding the existent details will delete the existing details and only put the new details. To avoid this, pass the new meta details along with the existing meta details.

**Example Response**

```json
{
    "message": "Metadata added successfully"
}
```