# MATCHALL

The `MATCHALL` field specifier (case sensitive) allows you to find documents in which a specified field occurs in multiple instances, and in which there is at least one match among those instances for each of a set of strings that you specify.

NOTE: You can optimize the field specifier speed by restricting the field to the MatchType property type.

To use the `MATCHALL` field specifier against fields that were added using the DREREPLACE index action, you must define the fields as MatchType.

## Format

    FieldText=MATCHALL{yourStrings}:yourField

`yourStrings` | One or more strings. A document is returned only if all these strings have exact matches among the instances of `yourField`. The matching is case-independent. You can match strings that contain punctuation (but see Note below) or consist of several words. NOTE: To distinguish query syntax punctuation from punctuation within strings, double-percent-encode commas and curly braces within strings. Query syntax punctuation must be left unencoded. There must be no space before or after a separator comma.
`yourField` | The name of the field to match against. A document returns only if it contains the field and only if all `yourStrings` are matched at least once in various instances of the field.

## Example

    FieldText=MATCHALL{Archive,Web,docs}:DIRECTORY

The `DIRECTORY` fields must include at least the values `Archive` and `Web` and `docs` for the document to return as a result.

    FieldText=MATCHALL{Smith,Garcia,Lee}:SURNAME

The values `Smith`, `Garcia`, and `Lee` must all have matches in the `SURNAME` fields for the document to return as a result.

    FieldText=MATCHALL{Smith%2C John, Garcia%2C Joaquin}:FULLNAME

The values `Smith`, `John` and `Garcia`, `Joaquin` must both have matches in the `FULLNAME` fields for the document to return as a result.

_FT_HTML5_bannerTitle.htm