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

# Search

> Find anything in your project instantly

## Overview

Search provides instant access to everything in your project. Quickly locate contracts, recordings, compositions, products, entities, and statements with a powerful search interface that includes category filtering, infinite scroll, and related resource discovery.

## Accessing Search

* Press `Cmd/Ctrl + K` anywhere in a project — a hint badge is also visible inside the search input
* Click the **Search** button in the project header

## What You Can Search

| Category         | Examples                                                                 |
| ---------------- | ------------------------------------------------------------------------ |
| **Contracts**    | File names, contract content (the actual contract text), extracted terms |
| **Recordings**   | Track titles, ISRCs, artist names                                        |
| **Compositions** | Song titles, ISWCs, writer names                                         |
| **Products**     | Product names, UPCs                                                      |
| **Entities**     | Company names, labels, publishers                                        |
| **Artists**      | Artist names                                                             |
| **Writers**      | Writer names                                                             |
| **Relations**    | Entity connections                                                       |
| **Statements**   | File names, sources                                                      |

## Search Filters

Click filter tabs to narrow results to a specific category. Catalog and CRM items are grouped into dropdown menus:

| Filter               | Shows                                           |
| -------------------- | ----------------------------------------------- |
| **Contracts**        | Only contract documents                         |
| **Catalog** ▾        | Dropdown: Recordings, Compositions, Products    |
| **Entities (CRM)** ▾ | Dropdown: Entities, Artists, Writers, Relations |
| **Statements**       | Only statement files                            |

When a filter is active, the search runs only against that category for faster results.

### Smart filter availability

When you type a query, filters that have **no matching results** are automatically dimmed and disabled. This lets you see at a glance which categories contain data relevant to your search — without having to click each filter individually.

<Note>
  Filter availability is only calculated for unfiltered (all-category) searches. If you activate a specific filter, the availability indicators are not shown. Clear the query to reset the filter state.
</Note>

## Recent Items

When you open search without typing a query, your **recently viewed items** appear at the top. This gives you one-click access to the contracts, recordings, entities, and other items you visited most recently.

* Items are saved automatically whenever you click a search result
* Click **Clear all** to remove your recent history

## Search Results

Results display with helpful context:

| Element      | Description                                     |
| ------------ | ----------------------------------------------- |
| **Title**    | Item name with search term highlighted          |
| **Context**  | Additional matching text (for content searches) |
| **Category** | Type of item (Contract, Recording, etc.)        |

### Related Resources

When your search returns **1–3 results**, the search panel automatically loads related items for each result — so you can jump directly to connected records without running additional searches.

| Result Type | Related Resources Shown                |
| ----------- | -------------------------------------- |
| Contract    | Entities, Recordings, Compositions     |
| Recording   | Contracts, Products                    |
| Composition | Contracts, Products                    |
| Product     | Recordings, Compositions               |
| Entity      | Artists, Writers, Relations, Contracts |
| Statement   | Recordings, Compositions, Contracts    |

### Infinite Scroll

Search loads 20 results at a time. Scroll to the bottom of the results list to automatically load the next page.

## Quick Actions & Navigation

When no search query is entered, the panel shows three groups of shortcuts:

| Group             | Contents                                                      |
| ----------------- | ------------------------------------------------------------- |
| **Quick Actions** | Ask AI (opens the AI Chat), Docs (opens documentation)        |
| **Navigation**    | Jump to Dashboard, Contracts, Catalog, Entities, Statements   |
| **Settings**      | Jump to your profile, Project Settings, Organization Settings |

## Keyboard Navigation

Navigate search results and perform actions entirely from your keyboard:

| Key                | Action                            |
| ------------------ | --------------------------------- |
| `↑` `↓`            | Move through results              |
| `Enter`            | Open selected result              |
| `Cmd/Ctrl + Enter` | Open selected result in a new tab |
| `Cmd/Ctrl + Click` | Open any result in a new tab      |
| `Esc`              | Close search                      |
| `Cmd/Ctrl + K`     | Toggle search open/closed         |

<Tip>
  Use `Cmd/Ctrl + Enter` or `Cmd/Ctrl + Click` to open a result in a new tab while keeping your current page open.
</Tip>

## Search Tips

<AccordionGroup>
  <Accordion title="Use specific terms">
    Search for ISRCs, entity names, or unique contract terms for precise results.
  </Accordion>

  <Accordion title="Filter by category">
    Click a category filter if you know what type of item you're looking for. The search runs only against that category server-side, so results load faster.
  </Accordion>

  <Accordion title="Search contract content">
    Search looks inside contract text, not just file names — search for specific clauses or terms.
  </Accordion>

  <Accordion title="Use partial matches">
    You don't need exact matches — partial text works for most fields.
  </Accordion>

  <Accordion title="Check recent items">
    Open search without typing to see your recently visited items for quick re-access.
  </Accordion>
</AccordionGroup>

## Project Scope

Search is scoped to your current project:

* Only searches data within the current project
* Ensures data privacy between projects
* Returns relevant, focused results

## Related Documentation

<CardGroup cols={2}>
  <Card title="AI Chat" icon="message-bot" href="/projects/ai-chat">
    Ask questions about your data in natural language.
  </Card>

  <Card title="Contracts" icon="file-contract" href="/projects/contracts/overview">
    Contract management and extraction.
  </Card>
</CardGroup>
