summaryrefslogtreecommitdiff
path: root/docs/user/search_syntax.rst
blob: 50cd8fabb63c1805665b2cc4af4e906b64334af3 (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
.. _search-syntax:

=============
Search syntax
=============

SearXNG allows you to modify the default categories, engines and search language
via the search query.

Prefix ``!``
  to set Category/engine

Prefix: ``:``
  to set language

Prefix: ``?``
  to add engines and categories to the currently selected categories

Abbrevations of the engines and languages are also accepted.  Engine/category
modifiers are chainable and inclusive (e.g. with :search:`!it !ddg !wp qwer
<?q=%21it%20%21ddg%20%21wp%20qwer>` search in IT category **and** duckduckgo
**and** wikipedia for ``qwer``).

See the :search:`/preferences page <preferences>` for the list of engines,
categories and languages.

Examples
========

Search in wikipedia for ``qwer``:

- :search:`!wp qwer <?q=%21wp%20qwer>` or
- :search:`!wikipedia qwer :search:<?q=%21wikipedia%20qwer>`

Image search:

- :search:`!images Cthulhu <?q=%21images%20Cthulhu>`

Custom language in wikipedia:

- :search:`:hu !wp hackerspace <?q=%3Ahu%20%21wp%20hackerspace>`

Multilingual Search
===================

SearXNG does not support true multilingual search.
You have to use the language prefix in your search query when searching in a different language.

But there is a workaround:
By adding a new search engine with a different language, SearXNG will search in your default and other language.

Example configuration in settings.yml for a German and English speaker:
 .. code-block:: yaml

    search:
        language : "de"
        ...

    engines:
      - name : google english
        engine : google
        language : english
        ...

When searching, the default google engine will return German results and "google english" will return English results.