Log in

Let your bot search Google

The Google Search power-up lets your bot search Google, or a single website, for information that isn't in its knowledge.

🚨

Google Search stops working on 1 January 2027

Google is retiring the Custom Search JSON API, the Google service this power-up uses, and existing users have until 1 January 2027 to move off it. From that date the Google Search power-up stops working. You can't add new Google Search power-ups. Use the Web search power-up instead. It can search the same site, and it can also read the pages and PDFs it finds. See Move from Google Search to Web search.

Who can do this: team owners and admins.

Web search is available to every team.

The quickest way is to open your Google Search power-up and click Switch to Web search. This adds a Web search power-up with the same name, description and site, with Let the bot read pages and PDFs off, and turns off Google Search. Check its settings, and click Save if you change anything.

To move by hand:

  1. Open your bot and go to the Power-ups tab. Open the Google Search power-up and copy its Power-up name, Description and Site.
  2. Go back to Power-ups, click New power-up, choose Web search and click Create power-up.
  3. Paste the Power-up name and Description. If the description says "Google", change it, for example "Search example.com for current information the knowledge base doesn't cover, like prices or news."
  4. Under What to search, add the Site to Allowed websites, as a hostname such as example.com without a path. If Site was blank, leave Allowed websites empty to search the whole web.
  5. Decide whether the bot should read pages. Google Search only gave the bot titles, snippets and links. To keep it that way, turn off Let the bot read pages and PDFs. Leave it on to let the bot open a result and answer from the page or PDF. Each page read uses message tokens.
  6. Leave Search depth on Fast.
  7. Click Save.
  8. On the Google Search power-up's card, turn the toggle off, or open its menu and click Delete. That way the bot isn't choosing between two search power-ups.

If you also added Browse web page only to read Google results, Web search can do that itself. Keep Browse web page if your bot reads links that visitors share.

What changes

Google SearchWeb search
WebsitesOne Site, or the whole webUp to 50 Allowed websites, or the whole web. Up to 50 Excluded websites
What the bot gets backA page of results: title, snippet and linkUp to 10 results: link, title, publish date and the passages that match the question
Reading pages and PDFsNeeds the Browse web page power-up, which can't read PDFsBuilt in, with Let the bot read pages and PDFs
Fixed Search queryYesNot yet
Display mode (cards or a table)YesNot yet. The bot links to the pages it used
Message tokensSearches don't use message tokensAbout 3,000 per Fast search, 15,000 per Thorough search and 3,000 per page or PDF read. See How usage is charged
Your own AI provider keySearches work when your team's message allowance is used upSearches stop when your team's message allowance is used up, until it resets or you add tokens

What happens on 31 December 2026

Any Google Search power-up that's still turned on on 31 December is switched to Web search for you that day, before Google's service closes on 1 January. It keeps its name and description, searches the same Site (or the whole web if Site was blank), uses Fast search depth and has Let the bot read pages and PDFs off, so the bot gets search results as it did before. From then, each search uses message tokens. A fixed Search query and a Display mode aren't carried over.

Google Search power-ups that are turned off aren't switched. If you'd rather yours wasn't switched, turn it off, reply to the notice email we sent, or email us before 31 December.

Change its settings

Until 31 December 2026, you can still edit a Google Search power-up you already have:

  • Site: a domain such as example.com to search only that site. Leave blank to search the whole web.
  • Search query: a fixed query to run every time the power-up is used. Leave blank to let the bot write the query.
  • Display mode: show results as cards or a table. See Show a power-up's results visually.

What the bot gets back

Each search returns a page of results, each with a title, a short snippet and a link. The bot answers from these and can ask for the next page of results. It doesn't open the pages themselves. To let it read a result in full, also add Browse a web page.

The bot uses Google Search to answer a question about flight prices from Birmingham to Prague, listing results with links

Check it works

  1. Chat with your bot while signed in and ask about something recent that isn't in its knowledge.
  2. Open View details on the power-up call to see the query the bot used and the results.

Troubleshooting

The bot searches when it should use its knowledge

Make the Description narrower, for example "Only search if the answer isn't in the context provided", or add a rule to your bot's prompt.

Results come from the wrong sites

Set a Site to restrict every search to one domain, or name trusted sources in the Description.

Last updated