We offer DNS masking, which allows you to show searchers search.YOURAGENCY.gov (instead of search.USA.gov). Follow these steps to mask your domain.
Create a CNAME in your external DNS records for
search.youragency.gov. Point it to
yoursitehandle.sites.infr.search.usa.gov. Your site handle is listed on the settings page in the Search Admin Center.
For example: if your site handle is
abc, the DNS record would look like this:
search.youragency.gov CNAME abc.sites.infr.search.usa.gov
NOTE: if your site handle contains a
., please replace it with a
-in your DNS record, e.g., for site handle
abc.gov.searchthe DNS record would look like this:
search.youragency.gov CNAME abc-gov-search.sites.infr.search.usa.gov
HTTPS, you will need to email us after your DNS records have been updated in order to be added to our SSL certificate. If your CNAME is not on our SSL certificate, browser security warnings will appear when your search results page attemps to load over
HTTPS. We are only able to offer top level domain masking with HTTPS: i.e.,
- When the setup is complete, change your search box’s form code action from
Your domain mask will work as soon as this DNS update is complete.
Troubleshooting tip: Many agencies have both internal and external DNS. Be sure to update your external DNS records (step 1) before changing your form code (step 2).
Did you know? Any search site within your domain may use the same domain mask and CNAME record, even if the CNAME is not associated with that particular site’s handle. To implement an existing mask for a search box, just do Step 2, above.
Did you know? Once the CNAME is set up, if visitors to your site happen to truncate the URL in the browser bar to http://search.youragency.gov (without any parameters), they’re automatically redirected to your agency’s homepage at http://www.youragency.gov.
Did you know? Most of our customers use a
search.youragency.gov mask (such as search.nih.gov). If the
search subdomain is already used by another application, you can use
findit, such as
findit.state.gov. We no longer support other subdomain patterns.