# 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](https://docs.yansalabs.com/onesearch/technical-docs/tips-and-tricks) section.
{% endhint %}

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

<figure><img src="https://1336192239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzAi4PhfZn8oRYwA2PPKF%2Fuploads%2F8J8rSMoCwU7TLNHH2bH4%2Fimage.png?alt=media&#x26;token=b33b5efd-fdeb-4fd2-8cf3-023c0bd24a4d" 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="https://1336192239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzAi4PhfZn8oRYwA2PPKF%2Fuploads%2FdW38tjK4HLrH3c6IR4S4%2Fimage.png?alt=media&#x26;token=15f71ef9-5fd8-4141-8446-9ca559ea7a86" 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="https://1336192239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzAi4PhfZn8oRYwA2PPKF%2Fuploads%2FGqTDyIV5lcNIT8h1ag4x%2Fimage.png?alt=media&#x26;token=0167fc81-d9f5-4adf-a37f-8001c7686f3e" 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="https://1336192239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzAi4PhfZn8oRYwA2PPKF%2Fuploads%2FkwYVuTIkE65b7GWkSsi3%2Fimage.png?alt=media&#x26;token=7bd0392e-7533-4881-a00f-75d962de2d49" 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="https://1336192239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzAi4PhfZn8oRYwA2PPKF%2Fuploads%2FfGFsidqzKejnV2vDzz5n%2Fimage.png?alt=media&#x26;token=7817025e-6021-4e63-8125-bdc2f65b15c4" 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="https://1336192239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzAi4PhfZn8oRYwA2PPKF%2Fuploads%2F2cGldEbY45JEtCBVX7bs%2Fimage.png?alt=media&#x26;token=2a094cca-ff31-416a-906d-40170e12aa45" alt=""><figcaption></figcaption></figure>
