--- title: Visual Elements slug: visual-elements createdAt: 2023-03-14T10:10:35.000Z --- ![](https://api.archbee.com/api/optimize/fRibh2_2NwaS_4MGgrZuA/EQD6ID_3U0l1U51SYMQ9G_ui.png "QuickQuery User Interface Overview") *** ## Status Icon The status icon is **located on the left** of the query field, and indicates if QuickQuery is enabled and if hints are being displayed. ::Image[]{src="https://api.archbee.com/api/optimize/fRibh2_2NwaS_4MGgrZuA/w15dNB5Dp1XhRDduGpsci_statusicon.png" size="42" width="610" height="304" position="center" showCaption="false"} :::ExpandableHeading ### QuickQuery is disabled ::Image[]{src="https://api.archbee.com/api/optimize/fRibh2_2NwaS_4MGgrZuA/k0gMR8r0q2u96h4l399kx_qqoff.png" size="28" width="277" height="120" position="flex-start" showCaption="false"} When the lightning bolt ⚡ is grey, QuickQuery is disabled. You can enable QuickQuery by clicking on the lightning bolt ⚡. ::: :::ExpandableHeading ### QuickQuery is enabled and hinting is enabled ::Image[]{src="https://api.archbee.com/api/optimize/fRibh2_2NwaS_4MGgrZuA/HC7YFq2Z0jz4TQ83VOy06_qqon.png" size="32" width="268" height="100" position="flex-start" showCaption="false"} When the lightning bolt ⚡ is yellow and the bottom arrow 🔽 is also yellow, QuickQuery is enabled and hinting is turned on. You can disable hinting by pressing **\[** **Esc ]** when typing a query (i.e. the cursor is inside the [Query Field](./#query-field)) and no [list of hints](./#hint-list) is being displayed. If a list of hints is being displayed, pressing **\[** **Esc ]** once will close it, and pressing it a second time will turn hinting off. ::: :::ExpandableHeading ### QuickQuery is enabled and hinting is disabled ::Image[]{src="https://api.archbee.com/api/optimize/fRibh2_2NwaS_4MGgrZuA/Mmy97aK-FPNaZ4KJMB4VZ_qqonhintingoff.png" size="34" width="271" height="83" position="flex-start" showCaption="false"} When the lightning bolt ⚡ is yellow and the bottom arrow 🔽 is grey, QuickQuery is enabled and hinting is turned off. You can turn hinting back on by pressing **\[** **Esc ]** when typing a query (i.e. the cursor is inside the [Query Field](./#query-field)). ::: *** ## Query Field ![](https://api.archbee.com/api/optimize/fRibh2_2NwaS_4MGgrZuA/gRVK9zL7dQfxxWWzcR6GK_queryfield.png) To search using QuickQuery, write your query inside the Query Field. It will automatically get color-highlighted to easily distinguish each part of the query - field types, operations, logical operators, and so on. Additionally, if [hinting is enabled](docId\:P4UIQLB6kdnaOydfb8uHB), a list of hints will get displayed as you type. If your query **contains an error**, the corresponding part of the query will get underlined and **an error message will get displayed**. These are fairly understandable when a simple error is involved (e.g. an invalid field name or operation is used), but **can get fairly cryptic** when you make a mistake that QuickQuery can't recognize. However, in those situations, highlighting stops working at the point the error occurred, so it's **usually obvious what the mistake is**. ::::VerticalSplit{layout="middle"} :::VerticalSplitItem ::Image[]{src="https://api.archbee.com/api/optimize/fRibh2_2NwaS_4MGgrZuA/8Kf8AzJtpjPeUmt0ish52_errorsimple.png" size="50" width="171" height="135" caption="A simple error message" position="center" showCaption="true"} ::: :::VerticalSplitItem ![](https://api.archbee.com/api/optimize/fRibh2_2NwaS_4MGgrZuA/8iwGZlvJ8PoTPP1u8jtbG_errorcomplex.png "A cryptic error message caused by an obvious mistake") ::: :::: *** ## Hint List ![](https://api.archbee.com/api/optimize/fRibh2_2NwaS_4MGgrZuA/sKd83fPUN__vIe5hC33Pc_hintlist.png) As you type your query inside the [Query Field](./#query-field), QuickQuery will **hint possible completions** by searching all permissible inputs and showing the ones that **contain the characters you wrote**. For example, in the picture above, all permissible inputs containing the characters "*age*" are shown. You can use the arrow keys **\[↑]** / **\[↓]** and **\[↵ Enter]** or the mouse 🖱️ to select a particular hint and have it inputed into the [Query Field](./#query-field). Each row contains the following information about the item in question, from left to right: - (Left) **Badge indicating type of item **- field, module or logical operation - (Left) **Label of item, if it exists, or system name** - (Left) **System name of item in parentheses, if aforementioned label exists** - (Right) **Badge indicating type of field, if applicable** ::Image[]{src="https://api.archbee.com/api/optimize/fRibh2_2NwaS_4MGgrZuA/KBVG1OjZZgwVNh_cu2bhp_nolabel.png" size="74" width="789" height="170" caption="The selected item represents a temporal field with no label" position="center" showCaption="true"} ::Image[]{src="https://api.archbee.com/api/optimize/fRibh2_2NwaS_4MGgrZuA/VCIXictuoQnF8MTRPeiyq_link.png" size="74" width="817" height="178" caption="The selected item represents a link to the Accounts module" position="center" showCaption="true"} ::Image[]{src="https://api.archbee.com/api/optimize/fRibh2_2NwaS_4MGgrZuA/F97D_SVnduuLqOTalwz9P_logical.png" size="74" width="814" height="69" caption="The selected item represents the AND logical operator" position="center" showCaption="true"} *** ## Buttons ::Image[]{src="https://api.archbee.com/api/optimize/fRibh2_2NwaS_4MGgrZuA/A0L39WFZH4omTRKYAeG_s_buttons.png" size="38" width="376" height="142" caption="The Search, Documentation, and Clear Results Buttons" position="center" showCaption="true"} ### Search Button The Search Button is red when a query is incomplete or contains an error, and green when a query is valid and can be used to search. The button is **disabled if no change has been made** to the query since the last search. If you need to execute the search again anyway (e.g. to refresh results), use **\[⇧Shift]** + **\[↵ Enter]** while the cursor is inside the [Query Field](./#query-field). ### Documentation Button The Documentation Button **`?`** leads to these webpages. ### Clear Results Button The Clear Results Button **`x`** is only enabled when a search has been executed, and **cancels the query that is currently active**.