Skip to main content
U.S. flag

An official website of the United States government

Dot gov

Official websites use .gov
A .gov website belongs to an official government organization in the United States.


Secure .gov websites use HTTPS
A lock ( ) or https:// means you’ve safely connected to the .gov website. Share sensitive information only on official, secure websites.

How to Add a New Search Site

Find it in the Admin Center: Home > Admin Center > Add Site

If you need to gain access to the analytics data of an existing search site, ask a team member at your agency to add you as a user. Please don't create a new search site as this action will not grant you the access you need.

Homepage URL

Tell us the homepage URL of your website. Enter a fully qualified URL, including the protocol, such as

Correct Syntax


Incorrect Syntax

  • (use
  • (use
  • (use the higher-level folder,
  • (use the higher-level domain,
  • (use the domain that resolves,

We use this homepage URL to:

  1. Seed your domains list.
  2. Scan for any social media accounts (Flickr and YouTube), your favicon to use on your search results browser tab, and RSS feeds that are linked from your homepage, or another page you specify on the Display Overview page.
  3. Link the default logo on your results page to your homepage.

Display Name

Display Name and Site Handle on's search results pageTell us the name of your website. Searchers see your display name on the results page, such as in your page title or best bets. We recommend using the plain language name for your agency or site, such as National Institutes of Health.

Site Handle

Your site handle is a unique identifier for your site. The site handle is included in the request you send us from your search box, to let us know which search site to use. We also include it in the URL of your search results page, again, to show which search site is being used. We recommend making this handle short and unique, such as nih.

Handles can have lowercase letters, numbers, periods, hyphens, and underscores only. They can’t have spaces and other punctuation.

Site Language

English is the default language for our results pages. If you will be searching against content in another language, you should choose another language for your search site — we support English, Spanish, and 66 other languages.

When English is selected, results will primarily include English language pages. All display text on the results page will also be in English.

If you select Spanish, results will primarily include Spanish language pages. All display text on the results page will also be in Spanish. (Localizations are provided by GSA’s team.)

If you select one of the other 69 languages, results will primarily include pages from the selected language when possible. Display text will be in the selected language when localizations are available, and in English when they’re not available.

We’ve published the localization files on Github, and we encourage you to contribute to them.

Troubleshooting Tip: For non-English sites, some agencies opt to include the specific location of the language’s content (such as or in their Domains to further refine the search results. Test the results for your non-English site with both the general and the language-specific location to determine which setting gives you the best results.

Troubleshooting Tip: Once you’ve added your site, you can edit your display name on the Settings page. If you later need to edit your site handle or language, email us at