---
title: EntityStringQuery
framework: appintents
role: symbol
role_heading: Protocol
path: appintents/entitystringquery
---

# EntityStringQuery

An interface that locates entities using arbitrary string input.

## Declaration

```swift
protocol EntityStringQuery : EntityQuery
```

## Mentioned in

Defining app entities for your custom data types

## Overview

Overview EntityStringQuery adds to a EntityQuery the ability to query instances by String. The String value against which entities are matched typically represents the name a user would use to refer to a particular instance.

## Topics

### Searching for entities

- [entities(matching:)](appintents/entitystringquery/entities(matching:).md)

## Relationships

### Inherits From

- [DynamicOptionsProvider](appintents/dynamicoptionsprovider.md)
- [EntityQuery](appintents/entityquery.md)
- [PersistentlyIdentifiable](appintents/persistentlyidentifiable.md)
- [Sendable](swift/sendable.md)
- [SendableMetatype](swift/sendablemetatype.md)