Skip to main content
MindTouch Success Center

Advanced search options

Use advanced search operators to filter searches for more exact results or to provide targeted searches for your users.

The search function respects user permissions, so users will not see search results for pages or files they do not have permission to view.

Search terms

A query is broken up into terms and operators. There are two types of terms: single terms and phrases:

  • A single term is a single word such as "research" or "analytics".
  • A phrase is a group of words surrounded by double quotes such as "custom CSS".

Multiple terms can be combined together with Boolean operators to form a more complex query (see below).

Search areas

There are three searchable namespace areas in MindTouch:

  • Main: The default namespace your search will only search in. This is your entire knowledge base.
  • Template: Searches all of your site's template namespace (found by appending /Template: to your MindTouch domain).
  • User: Searches all pages created under the user namespace.

Using the MindTouch default search, you cannot search outside of the main namespace. You can add or remove constraints to other search endpoints. For more information, contact MindTouch Support.

Search constraints and examples

Basic search

Use any words or phrases to perform a search.

  • single term: Single word. No formatting needed. This is your basic search. Example = Google
  • phrase: A group of words that make up a phrase. Must be surrounded by quotation marks. Used when looking for a specific array of words. Example = "Getting Started"
Search constraints

Searches can constrain your search results to a specific section of your site.  

author:<text>: Lists all pages that are authored by a certain user. The last person to make changes to an article is considered an author. Example: author:JamesV

content:<text>: Only searches within the content of a page or file. This does not include titles, tags, file names, descriptions, etc. Example: content:Irrevo.

date.created:<yyyymmdd*>: Searches for all articles or files created at a certain date. The format is YYYYMMDDhhmmss. You may append an asterick (*) to search for everything within a certain date range. The example shows all articles created in 2014. Example: date.created:2014*

date.edited:<yyyymmdd*>: Searches for all articles or files edited at a certain date. The format is YYYYMMDDhhmmss. You may append an asterick (*) to search for everything within a certain date range. The example shows all articles edited in 2015. Example = date.edited:2015*

description:<text>: Only searches file descriptions. If multiple words are being searched, they must be wrapped in quotes (see example). Example: description:"MT4 Category Image"

extension:<extension>: Lists only files associated with a certain file extension. Example: extension:mtarc

tag:<tag>: Lists all pages that are tagged with the specific tag you are searching. (You can also click the tag in Page Settings on any page to trigger a search for all pages associated with that tag.) Example: tag:search

title:<title>: Only returns search results that are specific to the page title. Example: title:"page"

script:"template('<template_path/template_name>/": Returns pages that contain a specific template. Note: This search does not search templates.

<search constraint>: Add a minus sign next to any of these constraints to exclude options from the search result. Example: editor -tag:customization

Boolean search

Boolean searches help link or unlink search queries. These are used in all popular search engines and are usually universal. Boolean searches are case sensitive and require capitalization. If you have more than two words, Boolean searches help refine the search.

OR: The OR operator displays one query or the other. Searching with multiple words (not a phrase in quotes) always searches with the OR operator. The more relevant search results are boosted if all of the words in the search are in the result. Example: Editor OR Table

AND: The AND operator only shows articles that include all of the words in the query. Searching with phrases acts similarly to using the AND operator. Example: Editor AND Table

NOT: The NOT operator removes the next word from the search results. This helps when you have a large population of results and know you would like to strip out a specific subset of results. Example: Editor NOT Table

Boosting search terms

When searching with multiple terms, you can boost a specific term to give it higher priority in the search. The higher the boost value, the more relevance is given to the term.

^: A query like "page editor" can have either "page" or "editor" boosted, depending on where ^ is appended. Example: page editor^2 or page^10 editor

Group search terms

Multiple clauses can be searched using parenthesis, similar to a math equation.This can be very useful if you want to control the Boolean logic for a query.

( ): Group words with parenthesis and use Boolean operators to separate them. For example: (mt4 OR tcs) AND advanced. This searches for either "mt4" or "tcs" and "advanced" in the query.

Escaping special characters

MindTouch supports escaping special characters that are part of the query syntax.

+ - && || ! ( ) { } ] ^ " ~ *  : \: To escape these characters, use "\" before the character. Click the button on the right to see how to search for (1+1):2. For example: \(1\+1\)\:2

This list of advanced search options in this article is not exhaustive. Other searches may be available. If you're trying to apply constraints via an API call to the search API, alternate formatting is required. Please contact MindTouch Support team to learn more.

  • Was this article helpful?