---
title: "Put Object Metadata"
url: https://docs.catalyst.zoho.com/en/sdk/javascript/v1/cloudscale/stratus/put-object-metadata/
description: "This page describes the method to execute circuits in your application with sample code snippets."
last_updated: 2026-09-09T10:45:38Z
service: CloudScale
type: general
related_links:
  - name: "Catalyst CloudScale"
    url: /en/cloud-scale/
  - name: "Stratus Help Documentation"
    url: /en/cloud-scale/help/stratus/introduction/
  - name: "Java SDK Documentation"
    url: /en/sdk/java/v1/cloud-scale/stratus/put-object-meta/
  - name: "Python SDK Documentation"
    url: /en/sdk/python/v1/cloud-scale/stratus/put-object-meta/
  - name: "iOS SDK Documentation"
    url: /en/sdk/ios/v2/cloud-scale/stratus/overview/
  - name: "Android SDK Documentation"
    url: /en/sdk/android/v2/cloud-scale/stratus/overview/
  - name: "Flutter SDK Documentation"
    url: /en/sdk/flutter/v2/cloud-scale/stratus/overview/
  - name: "REST API Documentation"
    url: /en/api/code-reference/cloud-scale/stratus/put-object-meta/#PutObjectMetadata
repository:
  name: "Repository"
  url: https://github.com/catalystbyzoho/zcatalyst-sdk-js
---

# Put Object Metadata

> **Note:** Ensure you have installed the [required package](https://docs.catalyst.zoho.com/en/sdk/javascript/v1/cloudscale/stratus/overview/#prerequisites) to use this SDK method.

You can use the `putMeta()` SDK method to add meta details for a required object stored in a bucket in Stratus. The `objectIns`, object reference used in the following code snippet is the [component instance](https://docs.catalyst.zoho.com/en/sdk/javascript/v1/cloudscale/stratus/create-object-instance/).

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

> **Note:** 

* Using the following 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.

* 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.

```javascript
const objectMeta = {
 "key1": "value1" ,
 "key2": "value2" 
};
const objMeta = await objectIns.putMeta(objectMeta);
console.log(objMeta);
```

#### Example of Expected Response

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