MMetadata /docs
⌘K
Docs/Tools/create_google_sitelink_extension

create_google_sitelink_extension

Add an extra clickable shortcut (sitelink) that appears beneath a Google Ads ad — helpful deep-links like "See Pricing", "Book a Demo", or "Contact Sales" with two short descrip…

Writes extensions

Creates or changes something in the account. Put it behind whatever review your agent uses.

What it does

Add an extra clickable shortcut (sitelink) that appears beneath a Google Ads ad — helpful deep-links like "See Pricing", "Book a Demo", or "Contact Sales" with two short description lines. Sitelinks lift click-through rate by giving searchers alternate landing paths to the same advertiser.

                ALSO KNOWN AS: sitelink, site link, extra link, ad link, secondary link, deep link, additional link, jump link

                KEYWORDS: sitelink, site link, link, deep link, shortcut, google ads, extension, pricing link, demo link, contact link, landing page, CTR, click through

                WHEN TO USE:
                - "Add a sitelink to our Google Ads library"
                - "Create a 'See Pricing' / 'Book a Demo' / 'Contact Sales' link extension"
                - "Register a new sitelink for the homepage redesign"
                - "I need a shortcut under our search ads that points to the new pricing page"

                WHEN NOT TO USE:
                - Want a non-clickable selling-point snippet ("Free Shipping", "24/7 Support") → use create_google_callout_extension
                - Want a labeled list of offerings (e.g. "Brands: Nest, Nexus") → use create_google_structured_snippet_extension
                - Same sitelink for Microsoft Ads / Bing → use create_microsoft_sitelink_extension (library entries are per-channel)
                - Anything for Facebook / LinkedIn / Reddit — ad extensions are a search-channel-only concept

                INPUTS (all required):
                - url:          destination the sitelink opens.
                - link_text:    visible link text (1-25 chars).
                - description1: first description line under the link (1-35 chars).
                - description2: second description line (1-35 chars).

                EXAMPLE:
                create_google_sitelink_extension(
                    url="https://example.com/pricing",
                    link_text="See Pricing",
                    description1="Plans for every team size",
                    description2="Start free, upgrade anytime",
                )

                Returns the persisted extension (id, externalId, type=SITELINK, channel=GOOGLE_ADS). A 400 usually means a character-limit was exceeded.

Arguments

ArgumentTypeNotes
url string required Destination URL the sitelink points to (non-blank).
link_text string required Visible link text. 1-25 characters.
description1 string required First description line. 1-35 characters.
description2 string required Second description line. 1-35 characters.

Request

curl
curl -s -X POST https://mcp-server.metadata.io/mcp \
  -H "Authorization: $METADATA_PAT" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"create_google_sitelink_extension","arguments":{"url":"<url>","link_text":"<link_text>","description1":"<description1>","description2":"<description2>"}}}'

Response

No recorded response. This tool writes to the account, so it is never executed to build these docs. The request above is still the exact shape to send. Nothing on this page is invented.

Other extensions tools:

All 160 tools · machine-readable index