Appearance
Fresh 2026
Ad Preview Plugin
Updated:May 21, 2026
The Ad Preview plugin is the easiest way for advertisers to preview ads on their own websites.
The plugin enables you to generate Right Hand Column, Feed, or Mobile previews of an ad by specifying a Creative Spec, Adgroup ID, or Creative ID. Previews can either be generated using a Social Plugin or through the Graph API.
Parameters
Required: One of creative, creative_id, or adgroup_id Required: ad_format, which replaces page_type parameter Optional: ad_account_id, targeting, post
The preview plugin requires you to be logged in with Facebook Login. If creative_id, adgroup_id, or ad_account_id is used, you must also have the permissions to access the Creative, Ad Group, or Ad Account respectively.
| Setting | HTML5 Attribute | Description |
|---|---|---|
ad_account_id | data-ad-account-id | Required when specifying a creative that uses image_hash |
adgroup_id | data-adgroup-id | Adgroup ID returned from a Graph API call. |
creative | data-creative | JSON-encoded creative spec. |
creative_id | data-creative-id | Creative ID returned from a Graph API call. |
ad_format | data-ad-format | One of: RIGHT_COLUMN_STANDARD, DESKTOP_FEED_STANDARD, MOBILE_FEED_STANDARD, or FACEBOOK_STORY_MOBILE. |
page_type | data-page-type | One of: rightcolumn, desktopfeed, or mobile. |
targeting | data-targeting | JSON-encoded targeting spec. |
post | data-post | JSON-encoded post specification according to the Pages API documentation. |
Graph API
Previews can also be generated using the Graph API. To generate a plugin-style preview, specify the additional parameter, ad_format, as described in the table above.
Did you find this page helpful?
ON THIS PAGE
Parameters
Graph API