Extension Setting Types

This guide provides an overview of the various types of extensions, which are all available both in extension setting services and feed services.

The "extension setting" indicates which extension setting class to use when using extension setting services. The "placeholder type" indicates which PlaceholderType enum value to specify when using feed services. The "placeholder field" indicates which enumeration to use to specify fields when doing the mapping.

App extensions

App extensions allow you to link directly to your mobile app from your ads. Users can click on the ad headline to be taken to your site, or on the extension to be prompted to install the app directly.

Call extensions

Call extensions let you add phone numbers to your ads. Users can tap on the phone number to call your business directly.

Callout extensions

Callout extensions let you include additional text, such as "Free shipping" or "Open 24/7", with your ad.

Location extensions

Location extensions can help users find your locations by showing an address, map, or distance with your ad. Users can tap the extension to get further details on your location.

Affiliate location extensions

Affiliate location extensions allow you to show the retail chains that carry your products, and help users find those stores.

Price extensions

Price extensions appear below your text ad and can show a set of up to 8 cards that users can view to differentiate options and prices. Users can go directly to the item that interest them on your site.

Promotion extensions

Promotion extensions highlight special sales and offers with your ads.

Structured snippet extensions

Structured snippet extensions are shown beneath your text ad in the form of a header (for example, "Destinations") and a list of values (for example, "Hawaii, Costa Rica, South Africa"). Only a predefined selection of headers is available (described in detail in the linked article).

Lead form extensions

Lead form extensions (beta) help you generate leads by letting users submit a form directly in your ad. This is an asset-backed extension.

Image extensions

Image extensions (beta) allow advertisers to upload visuals to complement their existing text ads. These images appear on the Google search results page, along with the ad headlines and descriptions.