* can be used for wildcard searches - for example "Car*" to find all items starting with "Car". |
+### Query Language
+
+| Modifier | Modifier Category | Description |
+|----------------------------------------------------------------------------------------------------------------------------------|-------------------|-------------------------------------------------------------------------------------------|
+| [PqlFilter](https://github.com/pimcore/generic-data-index-bundle/blob/1.x/src/Model/Search/Modifier/QueryLanguage/PqlFilter.php) | Query Language | Apply a [Pimcore Query Language (PQL)](../09_Pimcore_Query_Language/README.md) condition. |
+
### Sort Modifiers
| Modifier | Modifier Category | Description |
diff --git a/doc/04_Searching_For_Data_In_Index/09_Pimcore_Query_Language/03_Use_PQL_as_Developer.md b/doc/04_Searching_For_Data_In_Index/09_Pimcore_Query_Language/03_Use_PQL_as_Developer.md
new file mode 100644
index 00000000..fdba58e6
--- /dev/null
+++ b/doc/04_Searching_For_Data_In_Index/09_Pimcore_Query_Language/03_Use_PQL_as_Developer.md
@@ -0,0 +1,103 @@
+# Use Pimcore Query Language (PQL) as a Developer
+
+## Execute searches based on PQL queries
+
+If you want to use the Pimcore Query Language (PQL) as a developer to search for data in the Pimcore Generic Data Index, you can use one of the following methods:
+
+#### 1. Search Modifier for the Generic Data Index search services
+
+You can use the [PqlFilter](https://github.com/pimcore/generic-data-index-bundle/blob/1.x/src/Model/Search/Modifier/QueryLanguage/PqlFilter.php) search modifier to filter search results based on a PQL query. The `PqlFilter` search modifier can be used with the search services provided by the Generic Data Index bundle. Take a look at the [Search Services](../README.md) documentation for details.
+
+#### 2. Direct use of the PQL processor to get the search query
+
+Use the `Pimcore\Bundle\GenericDataIndexBundle\QueryLanguage\ProcessorInterface` together with the `Pimcore\Bundle\GenericDataIndexBundle\Service\SearchIndex\IndexEntityServiceInterface` to process a PQL query.
+
+```php
+// inject both services via Symfony dependency injection
+/** @var \Pimcore\Bundle\GenericDataIndexBundle\QueryLanguage\ProcessorInterface $queryLanguageProcessor */
+/** @var \Pimcore\Bundle\GenericDataIndexBundle\Service\SearchIndex\IndexEntityServiceInterface $indexEntityService */
+
+$query = $queryLanguageProcessor->process(
+ 'color = "red" or color = "blue"', // The PQL query
+ $indexEntityService->getByEntityName('Car') // 'Asset', 'Document' or the name of the data object class
+);
+
+// $query is now a valid OpenSearch query array which can be used to search in the index
+```
+
+## Exception Handling
+
+In both cases, the PQL processor will throw an exception if the PQL query is invalid. The exception message will contain detailed information about the error. Especially when you would like to allow users to enter PQL queries, you should catch the exception and provide a user-friendly error feedback.
+
+##### Example
+
+This example will produce a error message like this:
+
+
+
+```php
+## Catching the exception
+use Pimcore\Bundle\GenericDataIndexBundle\Exception\QueryLanguage\ParsingException;
+
+try {
+ $pqlQuery = 'series = "E-Type"
+ and color "red"';
+
+ $query = $queryLanguageProcessor->process(
+ $pqlQuery, // The PQL query
+ $indexEntityService->getByEntityName('Car') // 'Asset', 'Document' or the name of the data object class
+ );
+} catch (ParsingException $e) {
+ // Provide user-friendly error feedback
+ return $twig->render('pql-syntax-error.html.twig', [
+ 'error' => $e->getMessage(),
+ 'syntaxBeforeError' => substr($e->getQuery(), 0, $e->getPosition()),
+ 'syntaxAfterError' => substr($e->getQuery(), $e->getPosition()),
+ ]);
+}
+```
+
+
+```twig
+{# pql-syntax-error.html.twig #}
+
+
+
+
+
+
+
+
+
+
+
+