---
schema: rendered-html/v1
title: "search | Developer Portal for YouTrack and Hub Documentation"
source_url: https://www.jetbrains.com/help/youtrack/devportal/v1-search.html
generated_at: 2026-06-11T15:21:01.206935+00:00
---

Feedback

Thanks for your feedback!

Was this page helpful?

YesNo

Developer Portal for YouTrack and Hub

- Developer Portal
- Apps
- MCP Tools
- YouTrack Workflows
- JavaScript Workflow Quick Start Guide
- Create a Workflow
- Edit a Workflow
- Workflow Rule Types
- Transactions
- Use Cases for Workflows
- Web-based Workflow Editor
- Using an External Code Editor
- Default Workflows
- Custom Workflow Repository
- JavaScript Workflow Reference
- Rule-specific Properties
- Context
- Requirements
- Using the Workflow API
- Building Integrations with Slack
- Using REST API Methods in JavaScript Workflows
- Working with Dates and Times
- [Working with Periods](jetbrains__com__help__youtrack__devportal__working-with-periods.md)
- Localized Workflow Messages
- Troubleshooting Workflows
- Remote Debugger
- YouTrack Workflow API
- Change Log
- date-time
- entities
- [http](jetbrains__com__help__youtrack__devportal__v1-http.md)
- [license](jetbrains__com__help__youtrack__devportal__v1-license.md)
- [notifications](jetbrains__com__help__youtrack__devportal__v1-notifications.md)
- [search](v1-search.html)
- [strings](jetbrains__com__help__youtrack__devportal__v1-strings.md)
- workflow
- YouTrack Import Scripts
- YouTrack Form API
- [YouTrack REST API](jetbrains__com__help__youtrack__devportal__youtrack-rest-api.md)
- Hub REST API

1. YouTrack Workflows
2. JavaScript Workflow Reference
3. YouTrack Workflow API
4. [search](#0)

# search﻿

Last modified: 07 May 2026

This module contains functionality that lets you search for issues in YouTrack.

## Functions﻿

### search﻿

```
static search(folder, query, user)
```

Returns issues that match a search query. If a sort order is not specified explicitly in the query, the issues that are returned are sorted in random order.

**Parameters**

| Name | Type | Description |
| --- | --- | --- |
| folder | WatchFolder | The project, tag, or saved search to set as the search context. If the value for this parameter is not provided, the search includes all issues. This is equivalent to a search that is performed in the user interface with the context set to Everything. |
| query | string, Object | A YouTrack search query. If Object, supports searching by extension properties. |
| user | User | The user account that executes the search query. The list of issues that is returned excludes issues that the specified user does not have permission to view. If the value for this parameter is not provided, the search query is executed on behalf of the current user. |

**Return Value**

| Type | Description |
| --- | --- |
| Set.<Issue> | The set of issues found by the search. |

**Example**

```
const search = require('@jetbrains/youtrack-scripting-api/search');
...
const query = {
    query: 'for: me State: {In Progress} issue id: -' + issue.id,
    extensionPropertiesQuery: {
        property1: "value1",
         property2: "value2"
    }
}
const inProgress = search.search(issue.project, query, ctx.currentUser);
if (inProgress.isNotEmpty()) {
  // Do something with the found set of issues.
}
```

- [search](/help/youtrack/devportal/v1-search.html)
- [Functions](/help/youtrack/devportal/v1-search.html#functions)
- [search](/help/youtrack/devportal/v1-search.html#search)

[notifications](jetbrains__com__help__youtrack__devportal__v1-notifications.md)[strings](jetbrains__com__help__youtrack__devportal__v1-strings.md)

- Privacy & Security
- Terms Of Use
- Trademarks
- Legal

Copyright © 2000–2026 JetBrains s.r.o.

![](https://bat.bing.com/action/0?ti=5220035&tm=gtm002&Ver=2&mid=3ccd82ed-32d1-461f-ad8a-b1a009905c50&bo=4&sid=452929b065a111f19a7fe7356f74a419&vid=aa3122f0648711f1a10d6d095e10fd87&vids=0&msclkid=N&pi=918639831&lg=en-US&sw=1920&sh=1080&sc=24&tl=search%20%7C%20Developer%20Portal%20for%20YouTrack%20and%20Hub%20Documentation&p=https%3A%2F%2Fwww.jetbrains.com%2Fhelp%2Fyoutrack%2Fdevportal%2Fv1-search.html&r=&lt=603&pt=1781191259509,65,65,,,1,1,1,1,1,,2,29,30,70,259,259,260,603,603,603&pn=0,0&evt=pageLoad&sv=2&asc=G&cdb=AQAS&rn=709983)

![](https://crawler.prototype.prolicht.digital/l/WQiyZi)![](https://crawler.prototype.prolicht.digital/l/Lf0Hpt)
