How to Add a New Search Site
Tell us the homepage URL of your website. Enter a fully qualified URL, including the protocol, such as
- usa.gov (use https://www.usa.gov)
- www.nasa.gov (use https://www.nasa.gov)
- https://www.sec.gov/litigation.shtml (use the higher-level folder, https://www.sec.gov/litigation)
- https://www.gsa.gov/portal/category/100000?utm_source=OCM&utm_medium=print-radio&utm_term=&utm_campaign=shortcuts (use the higher-level domain, https://www.gsa.gov)
- http://www.doc.gov (use the domain that resolves, https://www.commerce.gov)
We use this homepage URL to:
- Seed your domains list.
- Scan for any social media accounts (Flickr, Twitter, 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.
- Link the default logo on your results page to your homepage.
Tell 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.
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
Handles can have lowercase letters, numbers, periods, hyphens, and underscores only. They can’t have spaces and other punctuation.
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 GobiernoUSA.gov 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.
Troubleshooting Tip: For non-English sites, some agencies opt to include the specific location of the language’s content (such as example.gov/language or language.example.gov) in their Domains to further refine the search results. Test the results for your non-English site with both the general example.gov and the language-specific location to determine which setting gives you the best results.