summaryrefslogtreecommitdiff
path: root/docs/search.markdown
blob: 338f0052c1525a21aafa66aacd1d0ef1671c0a8b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
Advanced Search Syntax
======================

Kanboard use a simple query language for advanced search.

Example of query
----------------

This example will returns all tasks assigned to me with a due date for tomorrow and that have a title that contains "my title":

```
assigne:me due:tomorrow my title
```

Search by status
----------------

Attribute: **status**

- Query to find open tasks: `status:open`
- Query to find closed tasks: `status:closed`

Search by assignee
------------------

Attribute: **assignee**

Query with the full name:

```
assignee:"Frederic Guillot"
```

Query with the username:

```
assignee:fguillot
```

Multiple assignee lookup:

```
assignee:user1 assignee:"John Doe"
```

Kanboard will search tasks assigned to the "user1" or "John Doe".

Query for unassigned tasks:

```
assignee:nobody
```

Query for my assigned tasks

```
assignee:me
```

Search by color
---------------

Attribute: **color**

Query to search by color id:

```
color:blue
```

Query to search by color name:

```
color:"Deep Orange"
```

Search by due date
------------------

Attribute: **due**

Query to search tasks due today:

```
due:today
```

Query to search tasks due tomorrow:

```
due:tomorrow
```

Query to search tasks due yesterday:

```
due:yesterday
```

Query to search tasks due with the exact date:

```
due:2015-06-29
```

The date must use the ISO8601 format: **YYYY-MM-DD**.

Operators supported:

- Greater than: **due:>2015-06-29**
- Lower than: **due:<2015-06-29**
- Greater than or equal: **due:>=2015-06-29**
- Lower than or equal: **due:<=2015-06-29**