Sign in

Glossary of terms

This resource is a glossary of terms for developers using advanced features to create Custom Search Engines.

Annotation

An annotation is the association of one or more labels and/or other attributes to a webpage, website or set of webpages.

Attribute

In a Custom Search Engine, an attribute is a characteristic or property of an Annotation.

Background Labels

Background labels are labels that are appended to all queries in a Custom Search Engine context and are used to exclude unrelated results.

Comment

A comment is any long text that you may want to associate with a label.

Context

A context is a list of facets that organize the labels for a Custom Search Engine.

Contributor

A contributor is a person that you trust and you want their work and expertise to improve your Custom Search Engine. You obtain a contributors to your search engine either by inviting them or accepting volunteers.

Facet

A facet is a conceptual grouping of related labels. A facet is composed of facet items and each facet item describes a label.

Facet Item

A facet item describes a label and the user facing title for the label.

Linked Custom Search Engine

A Custom Search Engine whose XML definition you host on your site. Linked Custom Search Engines are referred to using the cref parameter in a search request. Read more about Linked CSEs.

Google Stored Custom Search Engine

A Google Stored Custom Search Engine is the one create through our wizard or upload through the "Advanced" section of the Control Panel. Google Stored Custom Search Engines are referred to using the cx parameter in a search request.

Label

Labels appear above the search results and enable users to refine their searches. The best labels correspond to refinements that are difficult to achieve by simply adding words to a query.

Mode

Mode is a label attribute that allows you to promote or demote results matching your label. Labels can have one of the following modes:

  • FILTER: Results without this label will not appear among the results.
  • ELIMINATE: Results with this label will not appear among the results.
  • BOOST: Results with this label will be preferred.

Score

A score determines how relevant a URL is to a label. Scores are assigned in the range [-1,1], where a negative value means that the URL is less relevant to the label and a positive score means that the URL is more relevant to the label.

Title

A title is a name given to a label or context that is displayed to the user.

URL Pattern

A URL pattern is a group of urls that match a given pattern. A pattern is specified by one or more *. A URL matches a URL pattern if it matches all of the characters before each of the * and everything after each of the *, where the * stands for any number of characters.

Volunteer

A volunteer is a person who finds your Custom Search Engine on Google Co-op interesting and requests that you accept them as a contributor.