# Adding OneSearch to a Workspace Record Page

{% hint style="info" %}
Before OneSearch will appear on a workspace, you must configure a **Form/Portal/Workspace** record for the table being shown in the workspace. More information on this can be found in the [Tips & Tricks](/onesearch/technical-docs/tips-and-tricks.md) section.
{% endhint %}

1. Open UI Builder to the desired workspace experience. Select the appropriate page and page variant.

<figure><img src="/files/LFyqQe0V5mRONwiQIRFE" alt=""><figcaption></figcaption></figure>

2. In the component tree, select the “Tab sidebar” component. Click the “+ Add” button in the config pane to add a new tab.

<figure><img src="/files/xcBof962f07Vi0dwaUee" alt=""><figcaption></figcaption></figure>

3. Choose to build the tab from an empty container (default option in the popup window) and then fill in the tab settings. Click “Create”.

<figure><img src="/files/Kkw1LyaKNGXrThQC107o" alt=""><figcaption></figcaption></figure>

4. In the component tree, click “+ Add component” under the newly created tab. Select the “YDS OneSearch - General Search Widget” component.

<figure><img src="/files/EcUHHXEiGWPoOLfMxXRB" alt=""><figcaption></figcaption></figure>

5. Set the properties in the config panel for the “YDS OneSearch - General Search Widget” component by binding “Table”, “Record”, and “Form fields” to the record data. Alternatively, if you do *not* want the OneSearch component tied to the record data, you can instead set the “Searcher override” property to one of your defined OneSearch Searchers. Setting the “Searcher override” will override the calculated Searcher determined by the previous properties.

<figure><img src="/files/0hxgqGKX4OtALWjtyJBU" alt=""><figcaption></figcaption></figure>

6. Save the changes and then open the record in the workspace to interact with the configured OneSearch component.

<figure><img src="/files/hb6WIeM4yL6dv8Ge2NBf" alt=""><figcaption></figcaption></figure>


---

# 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://docs.yansalabs.com/onesearch/onesearch-for-workspaces/adding-onesearch-to-a-workspace-record-page.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.