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.
Move from Google Search to Web search
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:
- 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.
- Go back to Power-ups, click New power-up, choose Web search and click Create power-up.
- 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."
- Under What to search, add the Site to Allowed websites, as a hostname such as
example.comwithout a path. If Site was blank, leave Allowed websites empty to search the whole web. - 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.
- Leave Search depth on Fast.
- Click Save.
- 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 Search | Web search | |
|---|---|---|
| Websites | One Site, or the whole web | Up to 50 Allowed websites, or the whole web. Up to 50 Excluded websites |
| What the bot gets back | A page of results: title, snippet and link | Up to 10 results: link, title, publish date and the passages that match the question |
| Reading pages and PDFs | Needs the Browse web page power-up, which can't read PDFs | Built in, with Let the bot read pages and PDFs |
| Fixed Search query | Yes | Not yet |
| Display mode (cards or a table) | Yes | Not yet. The bot links to the pages it used |
| Message tokens | Searches don't use message tokens | About 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 key | Searches work when your team's message allowance is used up | Searches 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.comto 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.

Check it works
- Chat with your bot while signed in and ask about something recent that isn't in its knowledge.
- 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.
Related
- Let your bot search websites live
Let your bot search chosen websites live and read the pages and PDFs it finds, for sites too large or too fast-changing to index.
- Let your bot read a web page
Let your bot fetch a web page during a chat and pull out what it needs. Use any URL or one fixed page, with CSS selectors, a custom prompt and basic auth.
- Message tokens and what happens when you run out
What message tokens are, how each message is counted, how model multipliers work, when tokens reset, and what happens when your team runs out.
Last updated