# Custom Search Query

When you display licenses using pre-defined filters, the corresponding search query is displayed in the search box above the list of licenses. For example, `status:active product:plesk`.

You can specify your own search query. The easiest way to do this is to type a value. This value will be searched for in the license number, license information, short description, and activation code (see The “value” Notation).

For a more specific search, use license attributes, such as platform or product version, as filters in your search query (see The “parameter:value” Notation). To find an exact phrase, use the “parameter:=value” notation.

Note

The search operation is case-insensitive.

## The “value” Notation

To use the “value” notation, just type the value you want to search for. For example, to search for licenses that contain plesk in their attributes, type the following search query:

    plesk

If the specified value is found in at least one of the attributes - License number, License information, Short description, or Activation code - then the license concerned will be displayed in the search results.

A value can contain spaces, parentheses, hyphens, double quotation marks, or other characters. If your search query contains only such a value, you do not need to put an entire value into quotation marks. For example:

    license for "customer-1" new

    (not "license for \"customer-1\" new")

To search by a license number, you can type the full number or just its middle part. Zeros at the beginning can be omitted. For example, to search for PLSK.02320288.0007, type either of the following:

    PLSK.02320288.0007
    PLSK.02320288
    02320288
    2320288

## The “parameter:value” Notation

Use the “parameter:value” notation to filter licenses by a certain attribute (parameter). A match to part of a parameter’s value is enough for a license to appear in the search results.

For example:

    keyos:unix

Note

For the list of all parameters and usage examples, see Parameters for License Search.

The “parameter:value” notation supports searching by several values or a range of values, specifying complicated values, and excluding a value from the search results.

To search by several values of one parameter:

Specify `(value1, value2, ...)`. For example:

    keyos:(unix, macos)

In this example, if the license parameter `keyos` is `unix` or `macos`, the license appears in the search results.

Use square brackets to search for the occurrence of all the specified values. Square brackets can be used only with the `addon` parameter. This parameter represents features added to a license.

For example:

    addon:["Security Core for Plesk 10/11 and Later", "5 Language Packs"]

In this example, if a license has the specified features (with the names matching the specified values), such a license appears in search results.

To search by a range of values:

Specify `(value1-value2)`. This is applicable only to numeric parameters. For example:

    keydomains:(10-1000)

Some parameters can take the `unlimited` value, for example:

    keydomains:(100-unlimited)

To specify a complicated value:

If a value contains spaces, parentheses, hyphens, or double quotation marks, put such a value into double quotation marks. Use a backslash before any double quotation mark that is part of the searched value. For example:

    desc:"license for \"customer-1\" new"

This rule also applies to the “value” notation if your search query has parameters in both “parameter:value” and “value” notations, such as:

    version:11 "license for \"customer-1\" new"

See also Searching by Several Parameters later on this page.

To exclude a value from search results:

To search for licenses that do not contain specific values, add a minus sign (“-“) before the corresponding parameter:

    -keyos:unix

## The “parameter:=value” Notation

Use the “parameter:=value” notation if you need exact value matching. By contrast, if you need matching by a part of a value, use the “parameter:value” notation.

For example:

    keyinfo:1yr

This search query finds licenses where `keyinfo` contains “1yr” as a part, for example “Plesk 10 and later with 1yr SUS” or “My Little Admin with 1yr support”.

    keyinfo:="plesk 10/11 for windows"

This search query finds licenses with `keyinfo` equal to “Plesk 10/11 for Windows”.

The “parameter:=value” notation supports searching by several values of a parameter, and specifying complicated values.

## Searching by Several Parameters

To include several search criteria in your search query, separate the criteria by adding spaces. Partner Central will find all the licenses that satisfy all the specified parameters.

For example, to find active licenses for Plesk 11.x that have the words license for “customer-1” new in the text attributes, type the following:

    status:active product:plesk version:11 "license for \"customer-1\" new"

## Excluding Values from Search Results

To search for licenses that do not contain specific values, add a minus sign (“-“) before the corresponding parameter:

    -keyos:unix

This operation is supported only for the “parameter:value” notation.

## Examples of the “parameter:value” Notation

To search for licenses that are issued for Windows and Unix, type the following search query:

    keyos:(windows, unix)

To search for licenses that are issued for the Virtuozzo containers product, type the following search query:

    product:pvc

To search for licenses that support from one to ten websites, type the following search query:

    keysites:(1-10)

## Examples of the “parameter:=value” Notation

To find licenses having a feature with the name “30 Domains w/1 yr SUS” or a feature with the name “Security Core for Plesk 10/11 and Later”, type the following:

    addon:=("30 Domains w/1 yr SUS","Security Core for Plesk 10/11 and Later")

To find licenses having both the features “30 Domains w/1 yr SUS” and “Security Core for Plesk 10/11 and Later”, type the following:

    addon:=["30 Domains w/1 yr SUS","Security Core for Plesk 10/11 and Later"]