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

# Adding a way to open the Search Modal

The search modal is what shoppers use to run a search and browse the results. You give them a way to open it by adding the **Depict Search** button block to your theme — commonly in the header.

<Steps>
  <Step title="Open the theme editor with the block pre-loaded">
    The easiest way is from the app itself: open **Search by Depict** in your Shopify admin and go to its **Onboarding** page, then click the button that opens your theme customizer — it loads the **Depict Search** app block ready to be placed in the header.

    Alternatively, open **Online Store → Themes → Customize** and add the **Depict Search** app block manually.
  </Step>

  <Step title="Place the block">
    Drag the block to where you want the search button — typically your header, next to or replacing your theme's own search icon.
  </Step>

  <Step title="Save">
    Clicking the button now opens the Depict search modal. Shoppers can also open it with the **Cmd/Ctrl + K** keyboard shortcut.
  </Step>
</Steps>

By default the block renders as an icon-only button. To show text next to the icon, set the **Button text** setting — see [Search button settings](/headless/shopify-app/blocks/search-button-settings) for everything you can customize on the button itself.

<Tip>
  Now that you've added Depict search to your site, we recommend hiding your old search entry points (and removing their JavaScript where possible) to avoid confusing shoppers and to improve page speed.
</Tip>

The modal's look and behaviour are configured globally through the app embeds — see the [search customization overview](/headless/shopify-app/blocks/search-customization-overview).

<Note>
  Can't place the block in your header? Your theme's header section doesn't support app blocks yet — [contact us](mailto:hello@depict.ai) and the Depict team will update your theme so it does.
</Note>