Custom Search

Search Labels

This page lists pre-built labels available to all custom search engines. Labels are discussed in detail in Changing the Ranking of Your Search Results and Helping Your Users Refine Their Searches.

You can use these labels as search engine labels that run in the background or as refinement labels that your users can click for a different result set.

Contents

This page includes the following sections:

Overview

Custom Search comes with a number of pre-built labels that you can use in your refinements.

The following example uses the pre-built shopping_comparisons label to promote shopping comparison sites in search results.

<GoogleCustomizations>
  <CustomSearchEngine volunteers="false">

    <Title>Product Review</Title>
    <Description>Compare products features</Description>

   <Context>
      <BackgroundLabels>
        <Label name="shopping_comparisons" mode="BOOST"/>
      </BackgroundLabels>
   </Context>

  </CustomSearchEngine>
</GoogleCustomizations>  

Not only can you use the pre-built labels, but you can also enhance them by adding and removing sites from them. For example, if you find that some of the pages that Google has labeled shopping_comparisons are not shopping-comparison pages or that Google has missed some great shopping comparison sites, you can add or remove those sites. You can improve the shopping_comparisons label by adding the appropriate annotations in your search engine or in a collaborative search engine to which you have access.

Back to top

Testing Search Labels

If you are not sure how a search label might work, you can experiment with it by using the more: search operator in a custom search engine. Take the search label called forum, for instance. Search for cartoon on Google search. Open a new browser window and this time, type more:forum cartoon in a custom search engine. Compare the search results between the normal search query and the search query appended with the more: operator and a search label.

Note: Do not include a space between the more: operator and the search label.

Pre-built Search Labels

The following sections list all the pre-built labels you can use.

Creative Commons

You can have your search engine include only sites that have stated their Creative Commons license. Creative Commons copyright license indicates the rights that the creator wants to reserve and the rights they are willing to give away for the benefit of the community. Each label corresponds to a specific licensing term.

Note: You can use these labels with filter mode only. You cannot use them as boost or eliminate labels.

free_use_share ("by-nc-nd" license)
free_use_share_commercially ("by-nd" license)
free_use_share_modify ("by-nc-sa" license)
free_use_share_modify_commercially ("by-sa" license)

Computer and Games

cheats
downloads
guides

Health: Conditions

causes_risk_factors
conditon_complications
condition_overview
condition_prevention
condition_symptoms
condition_treatment
prognosis

Back to top

Health: Drugs

alternative_medicine
drug_interactions
drug_overdose
drug_side_effects
drug_uses
drug_warnings_recalls

Health: Groups and Audience

for_health_professionals
for_patients
health_children
health_continuing_education
health_men
health_seniors
health_support_groups
health_teens
health_women
medical_authorities
patient_handouts

Back to top

Health: Miscellaneous

clinical_trials
practice_guidelines
research_overview

Health: Tests and Procedures

tests_diagnosis
test_procedure_complications
test_procedure_overview
test_procedure_prep
test_procedure_recovery
test_procedure_results

Images

auto_images
sample_photo_video
screenshots
videos

Back to top

Miscellaneous

accessible
manufacturers
professional_content
user_content

News and Publication

blogs
faq
forums
news

Back to top

Recency

You can use the recency labels to promote results by the freshness of the webpages. The labels vary in how intensely they boosts new content.

The weakest label, recent1, is best applied to search engines that search static content that is rarely updated, such as classic literature or archived reports. At the other extreme, recent4 is best applied to search engines that search current content that is frequently updated, such as daily stock or market reports. It is the closest approximation to "sorting by date." The other two labels are somewhere in between.

recent1 (static content that is updated rarely, such as annual reports, or archived documents)
recent2 (content that is updated approximately quarterly, such as reviews for bicycles)
recent3 (content that is updated approximately weekly or monthly, such as a magazine)
recent4 (current content that is updated daily, such as the news or comic strips)

Reviews

negative_reviews
professional_reviews
reviews
user_reviews

Back to top

Shopping and Product Research

accessories
comparisons
deals
news_recalls
pricing
product_manuals
safety_ratings
shopping_comparison
specifications
stores
troubleshooting

Travel and Entertainment

dining_guides
lodging_guides
maps
museum_activities
nightlife_activities
outdoor_activities
sightseeing
suggested_itineraries
tours_day_trips
travelogue

Back to top

Authentication required

You need to be signed in with Google+ to do that.

Signing you in...

Google Developers needs your permission to do that.