Customize Stories

Updated: May 3, 2024

If you transform a non 9:16 ad creative into a full-screen story format, you can also edit the generated background colors.

You can edit the background color for the top and bottom above and below your ad creative by using a hex color code. You can choose separate colors for the top and bottom.

This feature works for all stories placements across Instagram, Facebook, and Messenger. It is also available for static single image ads, video ads, and ads using placement asset customization.

Get Started

To use this API, make a POST request to portrait_customizations under AD_ACCOUNT_ID/adcreatives:

portrait_customizations: {
    specifications: [
        {
            background_color: {
                bottom_color: "0D3F0C", // RGB HEX string
                top_color: "CC8400", // RGB HEX string
                },
        },
    ],
}

To read your color settings, make a GET request to AD_CREATIVE_ID?fields=portrait_customizations.

The response looks like this:

{
  "portrait_customizations": {
    "specifications": [
      {
        "background_color": {
          "top_color": "0D3F0C",
          "bottom_color": "CC8400"
        }
      }
    ]
  },
  "id": "AD_CREATIVE_ID"
}

Limitations

• Not supported for Advantage+ creative for catalog ads.
• Not supported for Collection ads and Advantage+ catalog ads.

Resources

• Ads Manager: Adjust Background Colors for Stories Ads⁠
• Ads Manager: Create Instagram Stories Ads⁠