how to create metafield in shopify

Shopify API 2023: How to create metafield for a product

You can use the Metafield resource to add extra information to other Admin API resources. Metafields can be used for various purposes, like adding a summary to a blog article. Metafields can also be used to share data with other Shopify apps. I will show you how to create metafield for a product with Shopify API using Postman.

Step 1: Generate API credentials from the Shopify admin

  • Log in to your Shopify admin
  • Go to Apps Manage private apps
Shopify dashboard
Shopify API 2023: How to create metafield for a product 8
  • Click Create a new private app
  • In the App details section, enter a name for your app, and an emergency developer email.
  • In the Admin API section, select the areas of your store that you want the app to access
Admin API section shopify
Shopify API 2023: How to create metafield for a product 9
  • Click Save

The Admin API section displays the app’s API key and password when you save the app’s details. In the next step, you’ll use these credentials to make authorized requests.

Step 2: Retrieve product id with Postman

You can use the API key and password you generated for your request’s basic HTTP authorization. The URL format for basic authorization is as follows:

https://{username}:{password}@{shop}.myshopify.com/admin/api/{api-version}/{resource}.json
Code language: JavaScript (javascript)
  1. {username} – The API key that you generated.
  2. {password} – The API password that you generated.
  3. {shop} – The name of your development store.
  4. {api-version} – The supported API version that you want to use.
  5. {resource} – A resource endpoint from the REST Admin API.

Or you can copy the Example URL in the Admin API section. Remember to change {resource} to products.

https://e175161fa050aa637380b9500e857ea0:[email protected]/admin/api/2021-07/products.json
Code language: JavaScript (javascript)
example URL
Shopify API 2023: How to create metafield for a product 10
  • Log in to your Postman and create a new workspace
  • Paste the URL above and click Get
postman example
Shopify API 2023: How to create metafield for a product 11
  • Find the product you want to create metafield and copy its ID

For example, my product id is 6794851549247

Step 3: Create metafield for a product with product id

  • Open a new tab in Postman and change the URL with this Endpoint.
POST /products/#{id}/metafields.json

For example, my URL:

https://e175161fa050aa637380b9500e857ea0:[email protected]/admin/api/2021-07/products/6794851549247/metafields.json
Code language: JavaScript (javascript)
  • In the Body section, click raw and choose JSON
create metafield for a  product
Shopify API 2023: How to create metafield for a product 12
  • Enter this code
{ "metafield": { "namespace": "newvalue", "key": "Image 1 Path", "value": "https://drive.google.com/file/d/1aUzK8PQ7qrDvz6sc1YfuoBl7m9uj1nFQ/view", "type": "string" } }
Code language: JSON / JSON with Comments (json)
  1. {namesapce} – A container for a set of metafields. You need to define a custom namespace for your metafields to distinguish them from the metafields used by other apps. Minimum length: 2 characters. Maximum length: 20 characters.
  2. {key} – The name of the metafield. Minimum length: 3 characters. Maximum length: 30 characters.
  3. {value} – The information to be stored as metadata.
  4. {type} – The metafield’s information type. See the full list of types.
metafield code postman example
Shopify API 2023: How to create metafield for a product 13
  • Click Send

Response

{ "metafield": { "owner_id": 6794851549247, "namespace": "newvalue", "key": "Image 1 Path", "value": "https://drive.google.com/file/d/1aUzK8PQ7qrDvz6sc1YfuoBl7m9uj1nFQ/view", "value_type": "string", "id": 19502841069631, "description": null, "created_at": "2021-11-09T17:39:52+09:00", "updated_at": "2021-11-09T17:39:52+09:00", "owner_resource": "product", "type": "string", "admin_graphql_api_id": "gid://shopify/Metafield/19502841069631" } }
Code language: JSON / JSON with Comments (json)
result metafield postman example
Shopify API 2023: How to create metafield for a product 14

The source of this metafield is an image I save on my Google drive. You can create as much as metafields as you want, change the {key} value.

I have just provided you with three steps to create Metafield using Shopify API. I hope it will be helpful for you when using the Shopify API. For more information, refer to our blog: What is an API?. Besides, you can see more Shopify API documentation in the developer docs.

If you don’t understand the tutorial’s content, you can watch this video for more overview.

Shopify API – Create Metafield for a product