# Results Box

A Results Box is a neat way of display data from another bloc and have it appear within the bloc you are working on. 

![A random test of a a Results Box field where the value being looked up is "Hi"](/files/eltzxloc52dhOyUDZ2Ta)

{% hint style="info" %}
Note: To determine what fields are shown or hidden in the results, this is controlled in the field parameters of the source data. All fields show by default but by using the Field Hidden option setting [Hide in Data Results Box](/blocworx-documentation/bloc-editor/managing-a-field/field-parameters/choose-hidden-options-for-this-field.md#hide-in-data-results-box) it wont appear in any Results Box fields.\
\
We are working to improve this, so that the fields that are shown or hidden in the results box can be controlled when building the Results box field itself, as opposed to changing parameters on the source field. This will you more freedom to build varying types of Results Boxes from the same bloc.
{% endhint %}

{% hint style="success" %}
Note: This field can be used with .docx file tables to generate lists of data in our [Template Builder](/blocworx-documentation/bloc/pdf-and-doc-file-templates.md). More information [here](/blocworx-documentation/bloc-editor/bloc-settings/manage-and-build-templates.md#sub-bloc-and-results-box-fields).
{% endhint %}

### Initial Field Parameters

| Parameter                           | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Select Bloc                         | This is used to find the bloc you are going to load the data from.                                                                                                                                                                                                                                                                                                                                                                                         |
| Only get data matching local fields | <p>Local Field to check: This is the field on the bloc you are working on, the value of this field will be used to search the bloc you are looking up.</p><p></p><p>Field to look up: This is the field that will be searched, so basically the value of the local field must equal the value of this remote field. The data shown will only have these matching values.</p><p></p><p>You can build as many searches as you want using the add button.</p> |

### Optional Field Parameters

<table><thead><tr><th>Parameter</th><th>Description</th><th data-hidden></th></tr></thead><tbody><tr><td>View Icon Url</td><td>If you enter a Url of the bloc in which the results box is loading data from, into this parameter, it shows an icon in the results box. When this icon is clicked, it will open the Url and you will have access to the matching record inside the Url. There you will be able to update the record and this will pass the new edited record back into your results box. </td><td></td></tr><tr><td>View Data Popup</td><td>If enabled, it will override the 'View Icon Url' option above, and instead, when you click the icon it will show the record in a popup. This will be a view mode only.</td><td></td></tr></tbody></table>

### Example of View Icon Url

<figure><img src="/files/9OdALdFPEv8dqqNQlQ7D" alt="" width="563"><figcaption><p>Parameter with  Url of bloc in which results box is loading data from</p></figcaption></figure>

<figure><img src="/files/F2LRepbDdY8jZWvYW88K" alt="" width="563"><figcaption><p>Click the view icon on the left of the record you wish to edit</p></figcaption></figure>

<figure><img src="/files/DuMS2q0rUOpgPH8zxWd1" alt="" width="563"><figcaption><p>The view icon opens the url of the record to edit</p></figcaption></figure>

<table><thead><tr><th>Parameter</th><th>Description</th><th data-hidden></th></tr></thead><tbody><tr><td>Select Remote field to sort by</td><td>You can also sort the results by a certain field for a neater display of data.</td><td></td></tr><tr><td>Tick this box to reverse the order of the results</td><td>Used to reverse the order of the results in the Results Box. </td><td></td></tr><tr><td>Show Delete Icon</td><td>Allows you to delete a record from the results box. It will show a delete button .</td><td></td></tr><tr><td>Allow Editing</td><td><p>When enabled, this shows a little edit icon which allows you to edit records within the results box. </p><p></p><p>Open Bloc popup to edit the record: When enabled, this opens the record in a new bloc pop up and allows you to edit the data.</p><p></p><p>Open record to edit in new tab: Allows you to edit the record directly in the bloc where the record is stored by opening a new tab. </p><p></p><p>Open record in new tab "show more": Allows you to view the record in a new tab where the record is stored.</p><p></p><p>Apply Bloc Initialisation Actions: See the following documentation for reference: <a href="https://manual.blocworx.com/blocworx-documentation/bloc/the-blocworx-process-flow#stage-1-bloc-initialisation">https://manual.blocworx.com/blocworx-documentation/bloc/the-blocworx-process-flow#stage-1-bloc-initialisation</a></p></td><td></td></tr><tr><td></td><td></td><td></td></tr><tr><td>Only Show the following fields</td><td>In this dropdown, you can pick which fields you want to show in the results box. You can show multiple fields using the add button.</td><td></td></tr><tr><td>Only Refresh the following fields after editing/deleting (Results Boxes or Dropdown/List Fields Only)</td><td><p>This option lets you load selected fields again after you delete or edit a record in another results box. </p><p></p><p>For example, you may have multiple results boxes in a bloc and when you edit or delete a record in a results box, it may effect the results in another results box. With this option enabled, the results box will update to reflect the changes in its records.</p></td><td></td></tr><tr><td>Set Values to Colours</td><td>This allows you to have a colour for selected values in your results box.</td><td></td></tr><tr><td>Record Duplication</td><td><p>Enabled this option if you wish to duplicate records in a results box. For example, if you have invoice 001 in a results box, there will be a duplicate button to press. Once pressed it will create a new record for invoice 002. It will duplicate the invoice and all line items. </p><p></p><p>To enable this option you must firstly, switch to edit mode and scroll down to 'Record Duplication Settings' and enable 'Show Duplicate Button in Form'. Secondly, you must go back to your results box and enable the 'Record Duplication' Parameter. To access the duplicate button, you will then select the record you wish to duplicate, select show more and in the 'Click to Edit' tab you should see the Duplicate Button. </p></td><td></td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://manual.blocworx.com/blocworx-documentation/bloc-editor/fields-tools-and-charts/charts-results-and-data-feeds/results-box.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.