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

# Search for Candidates in Juicebox

> Learn how to use Juicebox most effectively.

## Introduction

Juicebox uses AI to understand your searches, configure filters, and support a full natural-language prompt, giving you real-life superpowers in searching through 800mm+ profiles.

<img src="https://mintcdn.com/juicebox-16ef85b6/9NO9AEp9WpKiqQSM/images/Screenshot-2026-07-30-at-4.27.10-PM.png?fit=max&auto=format&n=9NO9AEp9WpKiqQSM&q=85&s=b6e2114361572d14923518cf653a594e" alt="Screenshot 2026-02-02 at 6.58.41 AM" lightAlt="Screenshot 2026-02-02 at 6.58.41 AM" darkAlt="Screenshot 2026-02-02 at 6.58.41 AM" className="dark:hidden" width="2462" height="1408" data-path="images/Screenshot-2026-07-30-at-4.27.10-PM.png" />

<img src="https://mintcdn.com/juicebox-16ef85b6/9NO9AEp9WpKiqQSM/images/Screenshot-2026-07-30-at-4.27.10-PM-1.png?fit=max&auto=format&n=9NO9AEp9WpKiqQSM&q=85&s=cd2b54dc10609bf4711eda2408f5a684" alt="Screenshot 2026-02-02 at 6.58.41 AM" lightAlt="Screenshot 2026-02-02 at 6.58.41 AM" darkAlt="Screenshot 2026-02-02 at 6.58.41 AM" className="hidden dark:block" width="2462" height="1408" data-path="images/Screenshot-2026-07-30-at-4.27.10-PM-1.png" />

## How to search in Juicebox

Every search in Juicebox starts inside a project. To search for candidates most effectively, please follow this method:

**Step 1:** Create a new project.

**Step 2:** From the project homepage, choose **Search** to start sourcing manually. If you do not already have an Agent setup in the project, you can toggle to **Agent** at any time if you'd rather have an Agent source in the background.

**Step 3:** Describe the type of candidate you are looking for using your natural language. The **more** details or context here, the better!

**Step 4:** Run your prompt to review the filters and criteria populated

**Step 5:** Select **Run search** to review your ranked search pool

![Screenshot 2026-02-02 at 6.57.39 AM](https://raw.githubusercontent.com/juiceboxwork/docs/kb-migration/images/search/Screenshot_2026-02-02_at_6-57-39_AM.png)

<Tip>
  **Reminder:** To **narrow** your search, edit your project’s filters. To **rank** your search, edit your project’s criteria.
</Tip>

## Dictating your prompt with voice

You can speak your prompt instead of typing it. Select the microphone button (**Start voice input**) in the project search box or the search page prompt, then start talking. A waveform shows while Juicebox is listening.

* Juicebox transcribes your speech into the input so you can review and edit it. It never submits your prompt automatically.
* Recording stops on its own after about 8 seconds if you haven't started speaking, shortly after you stop speaking, or after 90 seconds. Select the button again (**Stop voice input**) to stop early.
* Select the microphone again to keep adding to what you already have.
* Juicebox improves recognition of names, skills and technical terms using your project, your recent searches and your Agent chat.
* Juicebox doesn't store your recordings.

<Note>
  Voice input isn't available to view-only admins, sequence seats or hiring managers. It's also off if your admin has [turned off recording](/intake#turn-recording-on-or-off) for your organization.
</Note>

If voice input doesn't start, check the message under the input:

| Message | What to do |
| - | - |
| Microphone access is blocked. Allow it in your browser settings to use voice input. | Allow microphone access for Juicebox in your browser's site settings, then try again. |
| We couldn't find a microphone. | Connect a microphone or check that your device's microphone is enabled. |
| Voice input isn't supported in this browser. | Try a different, up-to-date browser. |
| Voice input is disabled for your organization. | Your admin has turned off recording in Account Settings. |
| Voice input isn't available right now. Try again. | Wait a moment and select the microphone again. |

## Reviewing results

Once you run your results, candidates will appear in a ranked view, giving you the best matched candidates right off the bat. Each profile will receive a score against the set criteria, and will be shown as:

1. **Good Match (Green thumbs up):** signifies that the criteria are fulfilled, either through explicit mention on the candidate’s profile or through AI inference.
2. **Potential fit (Yellow thumbs up):** suggests that the criteria are likely met but with some ambiguity, or that there is some evidence missing. \*\*
3. **Not a match (Red stop sign):** indicates that there is no evidence that the criteria are met based on the information available. \*\*

![Screenshot 2026-02-03 at 8.30.26 AM](https://raw.githubusercontent.com/juiceboxwork/docs/kb-migration/images/search/Screenshot_2026-02-03_at_8-30-26_AM.png)

To gain deeper insight into an individual candidate or action on multiple candidates at once, switch between the Classic and Table views.

### **Classic view**

Use Juicebox’s classic view to individually review candidates and their match analysis.

![Screenshot 2026-02-03 at 8.34.35 AM](https://raw.githubusercontent.com/juiceboxwork/docs/kb-migration/images/search/Screenshot_2026-02-03_at_8-34-35_AM.png)

To learn more about a candidate:

1. Select the candidate’s name to review their full profile
2. **Recommended:** Select Review at the top to open a side-by-side view of the candidate’s background and Juicebox’s match analysis. Interact with each criterion to see exactly where that experience appears within the candidate’s profile.

### **Table view**

Use Juicebox’s table view to efficiently review and select a larger set of candidates alongside a snapshot of their match analysis.

![Screenshot 2026-02-03 at 8.35.37 AM](https://raw.githubusercontent.com/juiceboxwork/docs/kb-migration/images/search/Screenshot_2026-02-03_at_8-35-37_AM.png)

To learn more about a candidate:

1. Select the candidate’s name to review their full profile
2. Tailor the table to include additional information such as Education, Location, Company and Job Title
3. Expand a single row in order to look at a candidate’s match analysis overview
4. **Recommended:** Select Review at the top to open a side-by-side view of the candidate’s background and Juicebox’s match analysis. Interact with each criterion to see exactly where that experience appears within the candidate’s profile

<Note>
  **Not finding the right results?** Open Insights to uncover data on your current search pool, and then tweak filters based on any misaligned skills, locations, employers, etc.
</Note>

## Shortlisting profiles

Shortlist the candidates you believe are a good fit in order to contact them directly, share with a hiring manager, or export back to your ATS.

To shortlist a candidate, you can:

1. Directly shortlist as you scroll from the classic or table view
2. Individually “Add to Shortlist” from the candidate’s profile or Review results
3. Bulk select > Add to Shortlist from the classic or table view

## Iterating on your search

Adjust your filters or criteria at any time to continue to iterate on your search and ensure you are finding the best candidates.

![Screenshot 2026-02-03 at 8.37.39 AM](https://raw.githubusercontent.com/juiceboxwork/docs/kb-migration/images/search/Screenshot_2026-02-03_at_8-37-39_AM.png)

## Running a search with an ATS job

Have your ATS connected?

Kick off a search straight from an ATS job. Set the toggle to Search and select "Use job description from \{\{ATS Job}}".<br /><br />*Available to business plans.*

<Frame>
  <img src="https://mintcdn.com/juicebox-16ef85b6/9NO9AEp9WpKiqQSM/images/image-(112).png?fit=max&auto=format&n=9NO9AEp9WpKiqQSM&q=85&s=343a8a25ecb011acd6fb8b9b2a901306" alt="Image (112)" width="2788" height="1380" data-path="images/image-(112).png" />
</Frame>

## Learn more

To learn more about filters vs criteria, please visit the Filters vs Criteria article [here](/filters-vs-criteria).
