Attach visual imagery (1-20 product / lifestyle shots) to a Google Ads text ad to lift click-through. BETA. Re-uses assets already uploaded to the Metadata image library — pass their IDs, not raw files.
ALSO KNOWN AS: image extension, image asset, ad image, visual extension, picture extension, photo extension, hero image
KEYWORDS: image, image extension, photo, picture, visual, hero, asset, library, BETA, google ads, extension, CTR
WHEN TO USE:
- "Attach images to our Google Ads text ad"
- "Add image library IDs 123 and 456 as an image extension"
- "Create an image extension showing product photos under our search ads"
WHEN NOT TO USE:
- The image is a logo / brand mark → use create_google_business_logo_extension
- You haven't uploaded the assets yet — image extensions reference library IDs, so upload to the image library first.
- Want to drive clicks via text snippets → use create_google_sitelink_extension / callout
- Same images for Microsoft Ads / Bing → use create_microsoft_image_extension
INPUTS:
- image_library_ids (required): 1-20 IDs from the Metadata image library.
- alternative_text: accessibility alt text (≤90 chars).
- display_text: short caption overlaid on the image (≤35 chars). E.g. "Shop Now".
- destination_url: landing page when the image is clicked.
EXAMPLE:
create_google_image_extension(
image_library_ids=[123, 456],
alternative_text="Product hero shot",
display_text="Shop Now",
destination_url="https://example.com/landing",
)