> ## Documentation Index
> Fetch the complete documentation index at: https://doc.lucidworks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Build a basic search interface in UI Studio Builder with Search Bar, Results, and Facets components.

This guide walks you through building a basic but functional search interface in UI Studio Builder. By the end, you will have a composition with a Search Bar, Results, Facets, Text, Image, and Button component working together as a complete search experience.

<Note>
  For more information, see [Compositions](/docs/lw-platform/lw-ui-studio/compositions).
</Note>

<Steps>
  <Step title="Add a composition">
    Navigate to **UI Studio** in the left navigation panel and click **Builder**.

    <Frame caption="The Compositions screen, where you create, manage, and publish your UI Studio compositions.">
      <img src="https://mintcdn.com/lucidworks/ttOgnfuG35q331Yl/assets/images/lw-platform/ui-studio/compositions-main.png?fit=max&auto=format&n=ttOgnfuG35q331Yl&q=85&s=f4dbb51ff11910f83cf8169f295b59b1" alt="" width="2048" height="1036" data-path="assets/images/lw-platform/ui-studio/compositions-main.png" />
    </Frame>

    On the Compositions screen, click **Create New UI**.
    Enter a name and description for the composition and click **Create**.

    <Frame caption="Add a new composition.">
      <img src="https://mintcdn.com/lucidworks/ttOgnfuG35q331Yl/assets/images/lw-platform/ui-studio/composition-add-new.png?fit=max&auto=format&n=ttOgnfuG35q331Yl&q=85&s=edd06b9be4a134296698bee6a2873697" alt="" width="331" height="292" data-path="assets/images/lw-platform/ui-studio/composition-add-new.png" />
    </Frame>

    The new composition is listed on the Compositions screen. You can now select the composition and build it.
  </Step>

  <Step title="Open your composition">
    On the Compositions screen, click a composition to open it in the editor.

    <Frame caption="Composition Editor screen">
      <img src="https://mintcdn.com/lucidworks/ttOgnfuG35q331Yl/assets/images/lw-platform/ui-studio/composition-new-editor.png?fit=max&auto=format&n=ttOgnfuG35q331Yl&q=85&s=b278cd085415046cc47371f1b3cb532d" alt="" width="2876" height="1082" data-path="assets/images/lw-platform/ui-studio/composition-new-editor.png" />
    </Frame>
  </Step>

  <Step title="Set canvas properties">
    Click the main canvas and then click the gear icon to open the **Customize** panel on the right. Set a background color to match your company's branding, or adjust the section dimensions. These settings can be refined at any time.

    <Frame caption="Customize canvas properties">
      <img src="https://mintcdn.com/lucidworks/ttOgnfuG35q331Yl/assets/images/lw-platform/ui-studio/composition-canvas-properties.png?fit=max&auto=format&n=ttOgnfuG35q331Yl&q=85&s=aeebfe42c44115426cbc5a184e88c181" alt="" width="2478" height="824" data-path="assets/images/lw-platform/ui-studio/composition-canvas-properties.png" />
    </Frame>
  </Step>

  <Step title="Add components">
    In the left panel of the Editor screen, click **Components**. Available components are listed in the left sidebar, organized into two categories: **Search** and **Content**.

    <Frame caption="Composition components">
      <img src="https://mintcdn.com/lucidworks/ttOgnfuG35q331Yl/assets/images/lw-platform/ui-studio/composition-components.png?fit=max&auto=format&n=ttOgnfuG35q331Yl&q=85&s=fae1ef879358dd48411b3a25e677045b" alt="" width="2856" height="1172" data-path="assets/images/lw-platform/ui-studio/composition-components.png" />
    </Frame>

    <Note>
      To customize each component, click the component in the Editor screen and select values in the **Customize** panel on the right. Set a background color to match your company's branding, or adjust the section dimensions. These settings can be refined at any time.
    </Note>
  </Step>

  <Step title="Add a Search Bar">
    <Card title="Search Bar" icon="search" href="/docs/lw-platform/lw-ui-studio/components/search-bar">
      Accept user queries and trigger search across your datastore.
    </Card>

    In the left sidebar, find the **Search Bar** under the **Search** category. Drag it from the sidebar and hover over the header section in the canvas. The interface indicates where the component will land as you hover. Drop it into position.

    <Frame caption="Search Bar component dropped into the header section">
      <img src="https://mintcdn.com/lucidworks/qwknCXYlTmFH7Hq2/assets/images/lw-platform/ui-studio/add-search.png?fit=max&auto=format&n=qwknCXYlTmFH7Hq2&q=85&s=fc5a1d5e154f2f733cabaa59c424e038" alt="" width="2048" height="1036" data-path="assets/images/lw-platform/ui-studio/add-search.png" />
    </Frame>

    The **Customize** panel opens on the right with the Search Bar configuration options. Configure the following:

    * **Datastore**: Select the datastore you want to use for search queries.
    * **Typeahead Datastore**: Select the datastore for autocomplete suggestions. This can be the same datastore as the one above.
    * **Placeholder Text**: Replace the default text with something descriptive for your users, such as `Search our site`.
    * **Typeahead**: Expand this section and toggle **Typeahead Enabled** to turn autocomplete on or off.

    For details on all Search Bar settings, see the [Search Bar](/docs/lw-platform/lw-ui-studio/components/search-bar) component documentation.
  </Step>

  <Step title="Add a Results component">
    <Card title="Results" icon="list" href="/docs/lw-platform/lw-ui-studio/components/results">
      Display search results in a table view with sorting and pagination.
    </Card>

    Drag the **Results** component from the **Search** category in the left sidebar and drop it into the body area of the canvas.

    <Frame caption="Results component in the canvas">
      <img src="https://mintcdn.com/lucidworks/qwknCXYlTmFH7Hq2/assets/images/lw-platform/ui-studio/add-results.png?fit=max&auto=format&n=qwknCXYlTmFH7Hq2&q=85&s=13e18436fe847c170bc2d6ab8ab0cda1" alt="" width="2048" height="1036" data-path="assets/images/lw-platform/ui-studio/add-results.png" />
    </Frame>

    In the **Customize** panel, set the **Datastore** to the same datastore you selected for the Search Bar. This ensures the Results component displays results from the same search. Adjust the **Pagination** setting from the default to control how many results appear per page.

    <Tip>
      Advanced compositions may use multiple Search Bars and Results components to support separate search experiences on the same page. For example, a company intranet might have one for document search and another for people search. To accommodate this, add a new section to the canvas by hovering between existing sections, where the option to create a new section appears.
    </Tip>

    For details on all Results settings, see the [Results](/docs/lw-platform/lw-ui-studio/components/results) component documentation.
  </Step>

  <Step title="Add a Facets component">
    <Card title="Facets" icon="filter" href="/docs/lw-platform/lw-ui-studio/components/facets">
      Let users narrow results by filtering on field values.
    </Card>

    Drag the **Facets** component from the **Search** category and drop it onto the canvas alongside the Results.

    <Frame caption="Facets component in the canvas">
      <img src="https://mintcdn.com/lucidworks/qwknCXYlTmFH7Hq2/assets/images/lw-platform/ui-studio/add-facets.png?fit=max&auto=format&n=qwknCXYlTmFH7Hq2&q=85&s=99c08be5a277270ba2b2e55f5c11ff02" alt="" width="2048" height="1036" data-path="assets/images/lw-platform/ui-studio/add-facets.png" />
    </Frame>

    In the **Customize** panel, set the **Datastore** to the same datastore as the Search Bar and Results. This ensures the facets filter the same set of results. Configure a few options to shape the filtering experience:

    * **Searchable Facet Value**: Toggle this on to add a search box within each facet category. This is helpful when a category has many values.
    * **Collapsible**: Toggle this on to let users collapse and expand individual facet categories to save space.
    * **Selected Facet Pills**: Toggle this on to show active filters as removable pills at the top of the facets panel.

    For details on all Facets settings, see the [Facets](/docs/lw-platform/lw-ui-studio/components/facets) component documentation.
  </Step>

  <Step title="Add content components">
    <Columns cols={3}>
      <Card title="Text" icon="font" href="/docs/lw-platform/lw-ui-studio/components/text">
        Add text content with rich styling options.
      </Card>

      <Card title="Image" icon="image" href="/docs/lw-platform/lw-ui-studio/components/image">
        Display images with optional links, borders, and fallback support.
      </Card>

      <Card title="Button" icon="hand-pointer" href="/docs/lw-platform/lw-ui-studio/components/button">
        Add navigation, export, or action buttons to your pages.
      </Card>
    </Columns>

    With the core search components in place, add content components from the **Content** category in the left sidebar: **Text**, **Image**, and **Button**.

    * **Text**: Drag a Text component onto the canvas. For example, place it above the Results component as a section heading. The canvas layout adapts flexibly as you place components.
    * **Image**: Drag an Image component next to the Search Bar in the header section. In the **Customize** panel, upload your company logo and set an appropriate width and height.
    * **Button**: Drag a Button component onto the canvas. In the **Customize** panel, set the **Type** to **Link**, enter a label such as `Visit our site`, and enter your company site URL in the **Page Path** field.

    Explore the configuration options for each component. For details, see the [Text](/docs/lw-platform/lw-ui-studio/components/text), [Image](/docs/lw-platform/lw-ui-studio/components/image), and [Button](/docs/lw-platform/lw-ui-studio/components/button) component documentation.
  </Step>

  <Step title="Save or publish your composition">
    When you are satisfied with your composition, use the toolbar at the top of the builder to save or publish it.

    <Frame caption="Publish confirmation screen">
      <img src="https://mintcdn.com/lucidworks/qwknCXYlTmFH7Hq2/assets/images/lw-platform/ui-studio/publish-composition.png?fit=max&auto=format&n=qwknCXYlTmFH7Hq2&q=85&s=7f877a345364cabd8a99003193195dd3" alt="" width="2048" height="797" data-path="assets/images/lw-platform/ui-studio/publish-composition.png" />
    </Frame>

    After publishing, preview the composition to see the user experience. Test a search query, apply facet filters, and confirm that the results update as expected.
  </Step>
</Steps>
