# Review layout candidates

### Overview

Once Quilter has finished exploring layout options for a job, it marks it as "complete" and returns one of three different "results."

1. <mark style="background-color:green;">**Successful**</mark>**:** Quilter successfully identified >95% complete candidates.
2. <mark style="background-color:orange;">**Unsuccessful**</mark>**:** Quilter couldn't find any >95% complete candidates.
3. <mark style="background-color:red;">**Failed**</mark>**:** Quilter encountered an internal error or issue during the layout job and couldn't return *any* layout candidates.

On the Candidate Review page, you can:

* **Select candidates** by clicking them in the left-hand sidebar.
* **Inspect candidates** by clicking "Detail View" to toggle individual board layers and object types (see [Detail view](/candidate-review/detail-view.md)).
* **Edit and update filters** to include or exclude candidates with specific design parameters (see [Filtering](/candidate-review/filtering.md)).
* **Review PRCs** for the selected candidate (see [Physics Rule Checks (PRCs)](/physics-rule-checks-prcs/overview.md)).
* **Download a candidate** to inspect it offline in your preferred CAD tool.
* **Duplicate the job** to create a new draft layout job with the same files, physics constraints, and design parameters (see [Job Actions](/job-actions.md)).

### Successful jobs

Jobs are successful if Quilter can place and route at least one layout candidate to >95% without DRC errors.<br>

{% hint style="success" %}
**Successful candidates within your design parameters**
{% endhint %}

* If Quilter generated successful candidates within your design parameters, they will be presented by default, with the current top pick highlighted for review.

{% hint style="success" %}
**Successful candidates – outside your design parameters**
{% endhint %}

* If Quilter generated successful candidates, but all were outside your specified design parameters, you will see the notification below.
* Clicking the "Show successful candidates" button will clear your design parameter filters and display the top pick among all candidates generated for your layout job.<br>

  <figure><img src="/files/QZS6wJ4slpkUJn3MC6Bx" alt=""><figcaption><p>Quilter generated 100% complete candidates, but outside your design parameters</p></figcaption></figure>

### Unsuccessful jobs

{% hint style="warning" %}
**No successful candidates generated**
{% endhint %}

* If Quilter was unable to generate any successful candidates at all, you will see the notification below.
* Clicking the "Show incomplete candidates" button will clear the filter and present the best <95% candidates generated by Quilter.

{% hint style="danger" %}
**No candidates returned**
{% endhint %}

* If Quilter was entirely unable to return any layout candidates for your job, you will see the notification below.
* This usually means that Quilter encountered an error or issue while generating your layout job and failed to complete it.
* Clicking the "Send us a message" button will start a chat with the Quilter team so we can resolve the issue for you.

<figure><img src="/files/9nKFNNsuCfNlAGixMEvu" alt=""><figcaption></figcaption></figure>

### Sorting and filtering&#x20;

<figure><img src="/files/1Q9WeRF6dUp7msFqx2xu" alt=""><figcaption></figcaption></figure>

On the Candidate Review page, you can use the design parameter filters at the top to narrow down the visible and recommended layout candidates.&#x20;

These filters start with your target design parameters, but you can adjust them while browsing the page to refresh the results.

We currently offer design parameter filters for the following:

* Single-sided placements
* Minimum trace width
* Minimum trace clearance
* Layer count
* Fabricator preference

For more information on filtering candidates, see [Filtering](/candidate-review/filtering.md).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.quilter.ai/using-quilter/review-layout-candidates.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.