> For the complete documentation index, see [llms.txt](https://docs.silkline.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.silkline.ai/suppliers/supplier-evaluations.md).

# Evaluations

Run structured supplier evaluations — collect assessments and qualification documents from suppliers, review their responses, and record an approval decision that updates the supplier's status

Supplier Evaluations give buyers a structured way to qualify and re-qualify suppliers. An *evaluation* bundles together the assessments and qualification steps you want a supplier to complete — questionnaires, document uploads, qualification orders — tracks their progress as the supplier responds, and ends with a recorded **decision** that sets the supplier's approval status.

Evaluations are useful for onboarding a new supplier, running a periodic re-qualification, or capturing a one-off review (such as collecting an updated certification). Buyers build and send the evaluation; suppliers complete the assessments from their portal or a share link; buyers review the responses and record the final decision.

{% hint style="info" %}
Supplier Evaluations are a module that must be enabled for your organization. If you don't see **Evaluations** in your navigation, see [Enabling Supplier Evaluations](#enabling-supplier-evaluations) below.
{% endhint %}

## Key concepts

<table><thead><tr><th width="191">Concept</th><th>Description</th></tr></thead><tbody><tr><td>Evaluation</td><td>A qualification effort for a single supplier. Each evaluation is numbered (e.g. "Evaluation 42") and made up of one or more steps.</td></tr><tr><td>Step</td><td>A single unit of work within an evaluation. A step is either an <strong>Assessment</strong> (a form of questions and document uploads the supplier fills out) or a <strong>Qualification order</strong> (an internal purchase order used to qualify the supplier).</td></tr><tr><td>Template</td><td>A reusable set of steps. Selecting a template when you start an evaluation seeds it with that template's steps so you don't have to assemble them by hand each time.</td></tr><tr><td>Step definition</td><td>A reusable step (with its form/questions and defaults) that templates and evaluations are built from. Step definitions are managed in settings.</td></tr><tr><td>Decision</td><td>The outcome recorded at the end of an evaluation. A decision sets the supplier's resulting approval status, allowed pedigrees, an effective date, and optional notes.</td></tr></tbody></table>

## The Evaluations page

Open **Evaluations** from the navigation to see all evaluations across your organization. The page has two tabs:

* **Evaluations** – every evaluation, with its supplier, status, owner, and dates.
* **Steps** – every step across all evaluations, useful for seeing all outstanding assessments and qualification work in one place.

From here you can **Start Evaluation** to begin one immediately, or **Schedule Evaluation** to create one with a future start date. To send one template to many suppliers at once, start from the Suppliers page (see [Sending to many suppliers](#sending-to-many-suppliers)).

## Evaluation statuses

An evaluation's status is computed automatically from where its steps are in the process:

<table><thead><tr><th width="167">Status</th><th>Meaning</th></tr></thead><tbody><tr><td>Scheduled</td><td>The start date is in the future — work hasn't begun yet. Suppliers can't see the evaluation until it starts.</td></tr><tr><td>Collecting</td><td>Evidence is still being gathered (or no steps have been added yet). This is the working state while suppliers complete assessments.</td></tr><tr><td>Reviewing</td><td>All steps have been collected, but some have not yet been accepted by your team.</td></tr><tr><td>Decision</td><td>Every step has been accepted. The evaluation is ready for you to record a decision.</td></tr><tr><td>Completed</td><td>A decision has been recorded for the evaluation, including one that left the approval status unchanged.</td></tr><tr><td>Cancelled</td><td>The evaluation has been explicitly cancelled.</td></tr></tbody></table>

## Starting an evaluation

Click **Start Evaluation** (or **Schedule Evaluation** for a future-dated one) and complete the form:

<table><thead><tr><th width="191">Field</th><th>Description</th></tr></thead><tbody><tr><td>Supplier</td><td><strong>Required.</strong> The supplier being evaluated. Approval decisions you record later apply to this supplier.</td></tr><tr><td>Evaluation Template</td><td><strong>Required.</strong> The template whose steps seed the new evaluation. A preview shows the steps the template will add before you create the evaluation.</td></tr><tr><td>Start date</td><td><strong>Required.</strong> When the evaluation begins. A future date keeps the evaluation in the <strong>Scheduled</strong> status, hidden from the supplier, until that date.</td></tr><tr><td>Deadline</td><td><strong>Optional.</strong> A target completion date for the evaluation. Must be on or after the start date.</td></tr><tr><td>Description</td><td><strong>Optional.</strong> A short label for the evaluation. This is auto-filled from the supplier, template, and start date, and you can edit it.</td></tr></tbody></table>

When you create the evaluation, the template's steps are copied into it. You can then add, remove, reorder, or adjust steps on the evaluation without affecting the template.

## Configuring steps

Each step on an evaluation can be configured individually:

<table><thead><tr><th width="191">Field</th><th>Description</th></tr></thead><tbody><tr><td>Title</td><td><strong>Required.</strong> The name of the step, shown to your team and (for supplier-visible steps) to the supplier.</td></tr><tr><td>Description</td><td><strong>Optional.</strong> Additional context or instructions for the step.</td></tr><tr><td>Type</td><td><strong>Assessment</strong> (a form the supplier completes) or <strong>Qualification order</strong> (an internal purchase order used to qualify the supplier). A step's type is set when it's created and can't be changed afterward.</td></tr><tr><td>Visibility</td><td>Who can see the step. <strong>Internal to your organization</strong> keeps the step private to your team; <strong>Visible to suppliers via login or share link</strong> exposes it to the supplier. Assessments default to supplier-visible; qualification orders default to internal.</td></tr><tr><td>Owner</td><td><strong>Optional.</strong> The team member responsible for the step.</td></tr><tr><td>Due date</td><td><strong>Optional.</strong> A target date for the individual step.</td></tr></tbody></table>

Edit a step's fields in place on the step's detail page or sidebar. A step must keep a title, so clearing the Title field is not saved.

For **Assessment** steps, you design the form — the questions and document-upload fields the supplier will fill out — using the built-in form builder. Questions can be marked required or optional and reordered as needed.

## Templates and step definitions

Templates and step definitions are managed under **Organization Settings → Supplier Evaluations**, in the **Templates** section. There are two tabs:

* **Evaluation Templates** – reusable bundles of steps. Choose a template when starting an evaluation to seed it with those steps.
* **Step Definitions** – the individual reusable steps that templates and evaluations are built from.

A **step definition** has the same core fields as a step on an evaluation, plus defaults that apply wherever it's used:

<table><thead><tr><th width="191">Field</th><th>Description</th></tr></thead><tbody><tr><td>Title</td><td><strong>Required.</strong> The name of the step.</td></tr><tr><td>Description</td><td><strong>Optional.</strong> Context or instructions for the step.</td></tr><tr><td>Type</td><td><strong>Assessment</strong> or <strong>Qualification order</strong>. Set on creation and immutable afterward.</td></tr><tr><td>Default visibility</td><td>The visibility applied to steps created from this definition. Assessments default to supplier-visible; qualification orders default to internal.</td></tr><tr><td>Default owner</td><td><strong>Optional.</strong> A team member assigned by default to steps created from this definition.</td></tr></tbody></table>

For Assessment definitions, you build the form once on the definition; every step created from it starts with that form.

With [data cleaning mode](https://docs.silkline.ai/administration-tools/data-cleaning-mode.md) on, the step definitions table shows a checkbox on every row:

* Select step definitions, click **Edit**, and set **Status** (archived), **Default visibility**, or **Default owner** on all of them at once.
* Select step definitions and click **Delete** to remove them permanently. A step definition used by an evaluation template can't be deleted — archive it instead.

### Starting from a sample

Both tabs offer a built-in sample library so you don't have to start from a blank page:

* **Evaluation Templates** – the **Start from a sample** section recommends ready-made templates (such as New Supplier Onboarding, Aerospace & Defense Supplier Qualification, Annual Supplier Review, and W9 collection). Click **Use template** to copy one — the template and all of its assessments are created in your library and you're taken straight to the new template.
* **Step Definitions** – click **Sample assessments** to browse individual sample assessments (quality system surveys, NDA acknowledgments, export compliance, and more), grouped by theme. Click **Add** to copy one into your step definition pool.

You can preview any sample assessment before adding it: click an assessment listed on a sample template card, or **Preview** in the sample assessments list, to open its form in the form builder and explore the questions. Nothing is saved until you add the sample.

Samples are copies, not links: once added, they're yours to rename, edit, and build on, and using the same sample again creates another copy with a numbered name (for example "Quality Management System Assessment (2)").

## Sending an evaluation to the supplier

When the evaluation is ready, click **Send** from the evaluation page to email the supplier a link to complete their assessments. If you've already sent it, the button becomes **Resend**. You can review and adjust the supplier contacts and message before sending.

Only steps that are **visible to suppliers** appear to the supplier; internal steps (such as qualification orders) stay private to your team.

A **Scheduled** evaluation can't be sent. Suppliers can't open it, through the portal or a share link, until its start date. **Send** becomes available on that date.

### Sending to many suppliers

On the Suppliers page, tick the suppliers to send to, or tick the page and choose **Select all** to take every supplier matching the current filter. Then click **Send evaluation** to create an evaluation from one template for each of them and email each one. The action appears when supplier evaluations are turned on for your organization and you have permission to both create and send them. A send can go to at most 500 suppliers, and archived suppliers are never included.

The form opens on one page, with a preview of the email beside it that updates as you edit. Choose any recipient under **Preview as** to see their email, with a summary of the send below it.

* **Template**: choose the evaluation template and an optional deadline, the same fields as **Start Evaluation**. The template's steps are listed below it, and the deadline is set on every evaluation and its steps.
* **Recipients**: under **Send to the first of these each supplier has**, each supplier is emailed at the contacts found by the first step that finds anyone: its request default contacts, its primary contact, its order default contacts, then its first contact with an email. Each step shows how many suppliers it reaches. Reorder steps with the arrows, remove ones you don't want, and add them back below the list. **Skip suppliers with an open evaluation from this template** is on by default. Click **not reached** to review which suppliers won't get the email and why. To change the suppliers, close the form and adjust your selection.
* **Email**: edit the subject, message, and CC. They start from your **Send Evaluation** email template. Fields in braces, such as `{{Supplier.name}}` and `{{Evaluation.title}}`, fill in separately for each supplier. Each email ends with a link to that supplier's evaluation.

Click **Send to N suppliers**, then confirm. Evaluations are created and emailed in the background, and each email is sent from your address. The form then shows how many are sent, and lists any supplier that failed or was skipped with the reason. You can close it at any time; sending continues.

### Sharing an evaluation

An evaluation is shared through its supplier. Anyone you share an evaluation with gets access to the whole supplier, not just this evaluation: they can view its open and closed POs, and view and respond to its check-ins and evaluations. The Share panel on the evaluation page names the supplier the access goes through.

To share with a specific person, pick one of the supplier's contacts in the Share panel, or type a new email address to add a contact. Silkline emails them a link to the evaluation. Access lasts 30 days.

## What the supplier sees

When a supplier opens the evaluation link, they land on an overview page showing your organization, the list of assessments to complete, and an **X of Y submitted** progress indicator. Each assessment shows its status:

<table><thead><tr><th width="167">Status</th><th>Meaning</th></tr></thead><tbody><tr><td>Not started</td><td>The supplier hasn't begun the assessment.</td></tr><tr><td>In progress</td><td>The supplier has saved some answers but hasn't submitted.</td></tr><tr><td>Submitted</td><td>The supplier has submitted the assessment for your review.</td></tr><tr><td>Accepted</td><td>Your team has reviewed and accepted the assessment.</td></tr></tbody></table>

Opening an assessment shows the form. Links in the form's instructions open in a new browser tab and are marked with an outbound arrow icon. While filling it out, the supplier can:

* **Save draft** – save progress without submitting and return later to finish. The Save button stays disabled until there are unsaved changes, and shows **No changes to save** when the form is unchanged.
* **Clear** – reset their answers.
* **Submit** – submit the assessment for your review. A submitted assessment moves to **Submitted**.
* **Download** – export the assessment as a PDF.

### AI assist for filling assessments

Suppliers can use an AI assistant to help fill out an assessment. They describe their answers in plain language — and can attach supporting documents such as certificates — and the assistant proposes values for the form. The supplier reviews the proposed answers, edits as needed, and submits. (Your team has the same AI assist available when filling an assessment on a supplier's behalf.)

## Reviewing and accepting responses

As suppliers submit assessments, your team reviews each step and moves it through its status. A step can be marked:

* **Pending** – awaiting the supplier's response.
* **Collected** – the supplier has submitted; ready for your review.
* **Accepted** – you've reviewed the response and accepted it.

You can review the supplier's answers, see the submission history in the activity panel, and download the assessment (with attachments) for your records. An accepted step shows who accepted it and when. If a reviewer rejects a collected step, it returns to **Pending** and shows who sent it back, when, and the reason they gave. Once **every** step is accepted, the evaluation moves to the **Decision** status, ready for you to record an outcome.

## Recording a decision

The decision is the formal outcome of the evaluation. Record it from the evaluation page:

<table><thead><tr><th width="191">Field</th><th>Description</th></tr></thead><tbody><tr><td>Resulting approval status</td><td><strong>Required.</strong> The approval status to apply to the supplier as a result of this evaluation (Approved, Evaluation, Restricted, Prohibited, or None). See <a href="https://docs.silkline.ai/suppliers.md#approval-statuses">Approval Statuses</a> for what each one means.</td></tr><tr><td>Preferred</td><td><strong>Optional.</strong> Marks the supplier as <a href="https://docs.silkline.ai/suppliers.md#preferred-status">preferred</a>. Available only when the resulting approval status is Approved; choosing any other status turns it off.</td></tr><tr><td>Resulting allowed pedigrees</td><td><strong>Optional.</strong> When the supplier pedigree allow list is enabled for your organization, the pedigrees the supplier is approved to supply as a result of this decision.</td></tr><tr><td>Effective date</td><td><strong>Required.</strong> The date the decision takes effect.</td></tr><tr><td>Decision notes</td><td><strong>Optional.</strong> Context or rationale recorded with the decision.</td></tr></tbody></table>

Recording a decision updates the supplier's approval status (and allowed pedigrees, if set) on the [supplier record](https://docs.silkline.ai/suppliers.md#approval-supplier-lists), and moves the evaluation to **Completed**.

You can **Revise** a recorded decision to change its values, or **Clear** it to remove the decision and return the evaluation to the **Decision** status.

### Completing without changing approval status

Some evaluations only collect paperwork and shouldn't change a supplier's standing — for example a yearly re-signed W-9, a capabilities assessment, or updated contact details. When recording the decision, choose **Unchanged** instead of **Update status** at the top of the decision form. The option shows the status the supplier keeps, for example **Keep Approved**.

With **Unchanged** selected, the resulting-status picker is hidden. If your organization uses the supplier pedigree allow list, the pedigree picker is replaced by a read-only line listing the pedigrees the supplier keeps, for example **Pedigrees stay T1, T2 - Qualification**. The effective date and notes work as usual. If the supplier keeps an Approved status, you can still turn **Preferred** on or off.

Saving completes the evaluation and leaves the supplier's approval status and allowed pedigrees as they are. The evaluation page shows **Approval status unchanged** with who recorded it and when, and the Evaluations page's **Decision** column shows **Unchanged**. You can **Revise** the decision later to set a new status, or **Clear** it to return the evaluation to the **Decision** status.

The **W9 collection** sample template is built for this: one W-9 assessment that asks for the legal entity name, tax classification, the last 4 digits of the TIN, and a current signed W-9. Use it for yearly W-9 refreshes and record the decision as **Unchanged** when the W-9 is accepted.

{% hint style="info" %}
Recording a decision is how an evaluation flows back into your Approved Supplier List. A decision of **Approved** moves a supplier you were evaluating into approved standing, while **Restricted** or **Prohibited** records the appropriate limitation directly on the supplier.
{% endhint %}

## Cancelling an evaluation

If an evaluation is no longer needed, it can be cancelled. Cancelled evaluations move to the **Cancelled** status and no longer require action.

## Enabling Supplier Evaluations

Supplier Evaluations are controlled by a module toggle under **Organization Settings → Supplier Evaluations**. When the module is disabled, the Evaluations page shows a message to contact your administrator, and the feature is hidden from navigation. An administrator can enable the module from that settings page.

## Frequently asked questions

<details>

<summary>What's the difference between an Assessment and a Qualification order step?</summary>

An **Assessment** is a form — questions and document uploads — that the supplier completes from their portal. A **Qualification order** is an internal purchase order used as part of qualifying the supplier; it stays private to your team. A step's type is chosen when it's created and can't be changed afterward.

</details>

<details>

<summary>What's the difference between a template and a step definition?</summary>

A **step definition** is a single reusable step (with its form and defaults). A **template** is a bundle of steps. When you start an evaluation, you pick a template and its steps are copied into the new evaluation.

</details>

<details>

<summary>Will editing a step on an evaluation change the template it came from?</summary>

No. When you start an evaluation, the template's steps are copied into it. Changes you make to steps on the evaluation don't affect the template or its step definitions.

</details>

<details>

<summary>Do suppliers see every step?</summary>

No. Only steps marked **visible to suppliers** appear to the supplier. Steps that are internal to your organization (such as qualification orders, by default) stay private to your team.

</details>

<details>

<summary>Can a supplier complete an evaluation without a Silkline account?</summary>

Yes. The evaluation email includes a share link that lets the supplier complete supplier-visible assessments without logging in. Suppliers with portal accounts can also access evaluations after logging in.

In FedRAMP-enabled organizations, share links are not anonymous: the supplier signs in with the email address the evaluation was sent to.

</details>

<details>

<summary>Does recording a decision change the supplier's record?</summary>

Yes. Recording a decision sets the supplier's resulting approval status — and allowed pedigrees, if specified — on the supplier record, and marks the evaluation **Completed**. You can revise or clear the decision later if needed.

</details>

<details>

<summary>Can I complete an evaluation without changing the supplier's approval status?</summary>

Yes. When recording the decision, choose **Unchanged**. The evaluation is marked **Completed** and the supplier's approval status and allowed pedigrees stay as they are. See [Completing without changing approval status](#completing-without-changing-approval-status).

</details>
