Google Ads guide

Google Ads Dynamic Keyword Insertion: How It Works

Google Ads dynamic keyword insertion (DKI) automatically inserts the keyword in an ad group that caused an ad to show into your ad text. It can make a headline or description reflect the keyword theme without creating a separate fixed ad for every keyword, but it does not insert the person’s exact search term. If the keyword is too long or cannot be inserted, Google uses the default text in the code.

DKI is useful only when every eligible keyword can fit the same sentence, offer, policy boundary, and landing page. It can create awkward grammar, unsupported claims, or misleading combinations when an ad group mixes products, audiences, or keyword formats. Google’s keyword insertion documentation explains the feature; this guide covers setup and safeguards.

What does keyword insertion insert?

Keyword insertion inserts one of the keywords in the ad group that caused the ad to show. It does not necessarily insert the person’s search term. The search term may be a close or meaning-based variant, while the keyword text selected for the ad is the text that appears in the insertion code.

For example, an ad might contain:

``text Buy {KeyWord:Chocolate} ``

If the eligible keyword is dark chocolate, the headline could show Buy Dark Chocolate. If the eligible keyword is too long to fit, or Google cannot insert it in the context, the default text Chocolate can be used. Google’s keyword insertion examples explain this distinction.

Keyword, search term, and ad text are different

Keep these concepts separate:

ConceptMeaning
Search termWhat the person typed or expressed in the search.
KeywordThe account’s matching term that made the ad eligible.
Insertion textThe keyword text or default text placed into the ad.

With exact matching, the keyword and search may be closely related, but they still are not interchangeable concepts. With broad or phrase matching, a search can express related intent without using the exact keyword wording. Do not promise that DKI will echo every search word-for-word.

What is the DKI syntax?

Type a left curly brace in a text ad or supported responsive search ad field and choose Keyword insertion from the dynamic-text options, or use the supported pattern:

``text {KeyWord:Default text} ``

The part before the colon controls capitalization, and the text after the colon is the fallback. Common capitalization options include:

CodeExample result for dark chocolate
{KeyWord:Chocolate}Dark Chocolate
{Keyword:Chocolate}Dark chocolate
{keyword:chocolate}dark chocolate

Use the insertion menu and current Google Ads editor to confirm the syntax accepted for the field. The default text is not optional in the practical design: it must make the sentence work when insertion cannot occur.

The default text is a real message

Write the fallback as carefully as the inserted keyword. It may appear when a keyword exceeds the available character space or cannot fit a policy, grammar, or formatting condition. A fallback such as “Services” should still make the headline, description, offer, and landing page clear.

Do not use a default that changes the claim. If the inserted version says “Buy Dark Chocolate” but the fallback says “Explore Snacks,” confirm that both point to the same offer and page. Test the sentence with the longest eligible keyword and with the default before saving.

Where can keyword insertion be used?

Google supports dynamic text in text ads and responsive search ads, and its customized-text guidance describes keyword insertion alongside other dynamic options. The exact field availability, character limits, and editor behavior can change, so use the live creation interface and current specifications.

For responsive search ads, DKI is one asset inside a larger set of headlines and descriptions. Google may combine that asset with others in different orders. Make sure the inserted phrase is grammatically compatible with every description and headline it may accompany. If a phrase must appear in a fixed place, understand the interaction between DKI and RSA pinning.

DKI is not an ad customizer

Keyword insertion uses keywords from the ad group. Ad customizers can insert business-data values such as products, categories, or prices from a data source. Location insertion uses location context. These features solve different problems and can have different setup and fallback rules. Choose the feature that matches the source and governance of the text you need to show.

How do you set up dynamic keyword insertion?

Use a deliberate sequence:

  1. Define the ad group’s one customer need and landing-page offer.
  2. Review every keyword that can trigger the ad, including its length, wording, grammar, and policy risk.
  3. Write the fixed part of the sentence and a default that works naturally.
  4. Add the keyword-insertion code through the ad editor’s dynamic-text menu.
  5. Check capitalization, character limits, punctuation, and the longest keyword.
  6. Preview the inserted and default versions in the headline or description.
  7. Confirm the ad and landing page remain accurate for every keyword.
  8. Save the ad and record the insertion field, default text, keyword set, and date.
  9. Review actual search terms, ad combinations, conversions, and qualified outcomes.

Google’s keyword insertion setup guidance describes the current account flow. Use the editor’s insertion control rather than hand-editing a pattern that the current field may not support.

Keep the ad group narrow enough

DKI is safest when every keyword can finish the same sentence and lead to the same offer. A group containing “enterprise audit,” “free course,” and “jobs” may produce keyword text that is grammatically possible but commercially wrong. Separate those intents before adding insertion.

The rule is about meaning, not only grammar. “Buy {KeyWord:Chocolate}” can be grammatically valid for several chocolate keywords while still making an unsupported promise for a keyword describing a recipe, class, or review. Inspect the actual keyword themes and the page each ad group serves.

Test the default deliberately

The default is part of the published ad, not a technical afterthought. Read the sentence with the default in place, then read it with each representative keyword. Test the shortest, longest, most specific, and most qualified terms. If one sentence cannot accommodate them all, use separate assets or separate ads instead of forcing DKI.

What can go wrong with keyword insertion?

Awkward grammar

Inserted keywords can change singular/plural agreement, verb choice, capitalization, punctuation, or word order. An ad that reads well for “accounting software” may read poorly for “best accounting software for startups.” Write the surrounding sentence so the range of eligible keywords fits, and do not assume a capitalization setting repairs grammar.

A misleading offer

The inserted keyword can make an ad appear to offer something the landing page does not. A dynamic phrase that names a product, location, price, or result must be true for the page and business. Review the inserted and default versions against policy and owner-approved claims.

Keyword too long for the field

When the keyword cannot fit, Google can use the default text. If the default is awkward or too vague, the ad may lose relevance or clarity. Keep the default within the field limit and test the longest keyword that can be eligible.

Wrong keyword, not search term

An advertiser may expect the exact query to appear, but DKI uses the eligible keyword. With broad or phrase matching, the query can be meaningfully different. Explain this to reviewers and do not use the inserted text as proof of what the person searched.

Policy or approval problems

Every possible inserted version must comply with Google Ads policies and applicable law. Google notes that keywords added through recommendations still need policy review after insertion. Check restricted terms, trademark use, regulated claims, capitalization, and destination requirements before publishing.

Dynamic text in the wrong field

DKI belongs in supported ad text fields, not automatically in a final URL or tracking template. Google’s setup guidance warns that if a landing-page URL does not work with dynamic text, leave keyword insertion out of the URL. Keep tracking parameters and destination structure explicit and testable.

How should DKI performance be measured?

Review dynamic insertion as part of the complete query-to-outcome path:

AreaWhat to inspect
Keyword setWhich keywords can be inserted and do they share one intent?
Search termsWhat did people actually search, and did it fit the offer?
Rendered messageDid the inserted or default text read naturally and truthfully?
Landing pageDid the destination fulfill the keyword and ad promise?
TrafficImpressions, clicks, CTR, cost, and query quality.
OutcomesConversions, qualified leads, sales, revenue, margin, or other value.
ChangesDid the keyword list, match type, budget, bid strategy, page, or tracking change?

Do not judge DKI by CTR alone. Inserting a keyword can make an ad look more relevant and attract more clicks, but it can also create a broad or misleading promise. Compare actual search terms and qualified outcomes with a clear baseline. If the ad uses a responsive search ad, review combinations rather than assuming the inserted asset appeared in every impression.

Keep the comparison explainable

Record the fixed sentence, insertion code, default text, eligible keyword set, ad group, final URL, match types, conversion action, bid strategy, and date. Avoid changing the keyword set and the landing page at the same time if the team needs to know whether the inserted message helped.

When should you avoid keyword insertion?

Avoid or delay DKI when:

  • the ad group contains unrelated products, audiences, or stages;
  • keywords differ in grammar, number, or word order in ways the sentence cannot support;
  • inserted terms could create regulated, comparative, or unsubstantiated claims;
  • the default text would be vague or misleading;
  • the final URL cannot fulfill every inserted variation;
  • the business needs a tightly controlled message rather than dynamic wording;
  • the team cannot review search terms and qualified outcomes.

A manually written RSA with distinct assets may be safer and clearer. Dynamic text is a tool for a well-defined group, not a substitute for ad-group structure or copy review.

Common keyword-insertion mistakes

Assuming DKI inserts the search query

It generally inserts the eligible keyword, not necessarily the exact words the person typed. Use the Search terms report to understand the query and the ad preview to understand possible insertion text.

Omitting a useful default

An empty, awkward, or generic fallback can make the ad fail when the keyword does not fit. Write and test the default as a first-class asset.

Using broad themes in one insertion sentence

DKI can make unrelated keywords appear inside one sentence even when the grammar works. Keep the ad group and landing page focused on one problem and offer.

Hiding a claim inside dynamic text

The inserted keyword still becomes ad text and must be accurate and policy-compliant. Dynamic formatting does not make a restricted or unsupported claim acceptable.

Ignoring capitalization and punctuation

Capitalization options change the visible text but do not fix a sentence that requires a different grammatical form. Test the full rendered line, not just the code.

Putting DKI in the destination without testing

Dynamic ad text and landing-page URLs have different jobs. Keep the URL stable unless the current feature and destination are intentionally designed and tested for dynamic text.

Treating more relevance as more value

The ad can look more closely matched while the resulting lead or sale becomes less qualified. Use conversion quality, value, and margin where those are the actual business decisions.

Dynamic keyword insertion checklist

Before publishing DKI, confirm:

  1. every eligible keyword fits one clear intent and offer;
  2. the inserted keyword is the text you intend to show, not an assumed search term;
  3. the default text is natural, accurate, and within the field limit;
  4. capitalization, punctuation, grammar, and long-keyword behavior are tested;
  5. every inserted version complies with policy and applicable requirements;
  6. the landing page fulfills the inserted and default messages;
  7. responsive-search-ad combinations and pinning, if used, remain coherent;
  8. conversion tracking and qualified outcome review are ready;
  9. the code, keyword set, default, owner, and date are recorded.

Practical next steps

Use Google Ads dynamic keyword insertion only when one sentence can accurately serve every keyword in the ad group. Write a strong default, test the longest and most specific terms, separate incompatible themes, review policy and landing-page fit, and measure qualified outcomes rather than CTR alone.

For responsive ad structure, read Google Ads responsive search ads. For fixed-message controls, see Google Ads pinned headlines. For measurement, review Google Ads conversion tracking. The free Google Ads audit for agencies can help with the checks it currently supports; it does not automatically add keyword insertion or write dynamic ad text.