Ads and Commerce
Ads and Commerce
Resources

Add Interactive Elements

Updated: Sep 17, 2025
You can add interactive elements so people can engage in your Instagram ads.

Product Tags

You can add product tags to your ads, using the product_tag_spec under interactive_components_spec. Under component, you will need to specify:
  • type as product_tag
  • product_id under product_tag_spec
    Note: The products need to be approved before it can be tagged.
  • The x and y parameters of position_spec
    Note: The x and y parameters are required for image ads and optional for video ads.
Sample of a single interactive_components_spec feed image/video media
curl \
  -F 'name=Sample Creative TESTING' \
  -F 'object_story_spec={
      "link_data": {
            "link": "https://www.facebook.com/",
            "attachment_style": "link",
            "call_to_action": {
                "value": {},
                "type": "LEARN_MORE"
            },
            "image_hash": "IMAGE_HASH",
            "image_crops": {},
            "preferred_image_tags": {},
            "media_elements": {},
            "customization_rules_spec": {},
            "retailer_item_ids": {},
            "collection_thumbnails": {}
        },
       "page_id": "PAGE_ID",
       "instagram_user_id": "<IG_USER_ID>"
    }

' \
  -F 'interactive_components_spec={
      "components": [
    {
      "type": "product_tag",
      "product_tag_spec": {
        "product_id": 4382881195057752
      },
      "position_spec": {
        "x": 0.5,
        "y": 0.5,
      }
    }
  ]
}' \
  -F 'access_token=<ACCESS TOKEN>' \
  https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/adcreatives
Sample of multiple interactive_components_spec objects for feed carousel media
curl \
  -F 'name=Sample Creative TESTING' \
  -F 'object_story_spec={
      "link_data": {
            "link": "https://www.facebook.com/",
            "attachment_style": "link",
            "call_to_action": {
                "value": {},
                "type": "LEARN_MORE"
            },
            "image_hash": "IMAGE_HASH",
            "image_crops": {},
            "preferred_image_tags": {},
            "media_elements": {},
            "customization_rules_spec": {},
            "retailer_item_ids": {},
            "collection_thumbnails": {}
        },
       "page_id": "PAGE_ID",
       "instagram_user_id": "<IG_USER_ID>"
    }' \
  -F 'interactive_components_spec={
        "child_attachments": [
            {
                "components": [
                    {
                        "type": "product_tag",
                        "position_spec": {
                            "x": 0.5,
                            "y": 0.5
                        },
                        "product_tag_spec": {
                            "product_id": 4382881195057752
                        }
                    }
                ]
            },
            {
                "components": [
                    {
                        "type": "product_tag",
                        "position_spec": {
                            "x": 0.2,
                            "y": 0.8
                        },
                        "product_tag_spec": {
                            "product_id": 4382881195057752
                        }
                    }
                ]
            },
            {
                "components": [
                    {
                        "type": "product_tag",
                        "position_spec": {
                            "x": 0.3,
                            "y": 0.7
                        },
                        "product_tag_spec": {
                            "product_id": 4382881195057752
                        }
                    }
                ]
            }
        ]
    }'\
  -F 'access_token=<ACCESS TOKEN>' \
  https://graph.facebook.com/v25.0/act<AD_ACCOUNT_ID>/adcreatives

Read Product Tag Information

You can get information about the product_id in your product_tag_spec object from an ad creative you created with the product_tag type.
To retrieve the product_tag_spec information from your ad creative:
curl -G \
  -d "fields=interactive_components_spec" \
  -d "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/v25.0/<AD_CREATIVE_ID>"
Sample Response
{
  "interactive_components_spec": {
    "components": [
      {
        "position_spec": {
          "x": 0.5,
          "y": 0.5
        },
        "type": "PRODUCT_TAG",
        "product_tag_spec": {
          "product_id": "4382881195057752"
        }
      }
    ]
  },
  "id": "23862467608880374"
}

Automated tagging for static ads

This feature automatically tags best-matched products from the your product catalog when you create ads using single images or carousel images you’ve uploaded and applies the relevant product tags to ads.
The automated tagging ad system detects matches in two ways:
  • Images in your catalog — If the features of your ad creative match with those in product images in your catalog, the ad system will automatically add the product tag to your ad creative.
  • Website URL in ad destination — If the website URL that you enter in the destination section at the ad level matches with items in your catalog, the ad system will automatically add the product tag to your ad creative.
If product tags are specified in the interactive_components_spec parameter, the automated tagging feature will be disabled for the ad to respect product tags that are specified by you.
Note: This feature is enabled by default. Set enroll_status to opt_out in the interactive_components_spec parameter to opt out of the feature per product item.
"interactive_components_spec": {
  "components": [
    {
      "type": "product_tag",
      "enroll_status": "opt_out"
    }
  ]
}
Note: You cannot set enroll_status and product_tag_spec at the same time; it will return an error.

Resources

Did you find this page helpful?
Thumbs up icon
Thumbs down icon