# Copilot Search

Use **Copilot Search** when you want a workflow step to search the web with Microsoft Copilot from Fetch Hive and pass the results into later workflow steps.

## Configuration

| Option                                                             | Required | Description                                                                                     |
| ------------------------------------------------------------------ | -------- | ----------------------------------------------------------------------------------------------- |
| Name                                                               | No       | Label for the step in the workflow canvas.                                                      |
| Search Query                                                       | Yes      | Query in **Search Query**. This field supports workflow variables through **Insert Variable**.  |
| Location                                                           | No       | Location value in **Location**. You can choose from the list or enable **Custom Value**.        |
| Location Custom Value                                              | No       | Controls whether **Location** uses the built-in list or a custom value.                         |
| When the step fails                                                | No       | Controls whether the workflow should **Terminate Workflow** or **Continue** if this step fails. |
| Add this step from the **Microsoft** group in **Search steps...**. |          |                                                                                                 |

The **Search Query** field supports **Insert Variable**. The **Location** field can use the built-in list or switch to **Custom Value** when you want to type a value manually or insert a workflow variable.

## Output

Click **Run** in the step header to test the step. Fetch Hive shows the search result output in **Output** after the run completes.

Use the variable picker in a later step to insert the exact output path available for that run. The base reference is:

```
{{STEP_IDENTIFIER.output}}
```

If you want the full result set, reference the base output directly:

```
{{step_2.output}}
```

Use the variable picker after a test run to inspect any nested fields available from the returned Copilot results.

## Example

Add **Copilot Search** from the **Microsoft** group in **Search steps...**.

Set **Name** to something like `Find Microsoft ecosystem coverage`.

Enter your query in **Search Query**. If the query should reuse values from earlier workflow steps, click **Insert Variable** and add that reference.

Choose **Location** from the list or switch to **Custom Value** if you want to type a location or insert a variable.

Choose what should happen in **When the step fails**.

Click **Run** and review the returned results in **Output** before using them in a later step.

## Notes

* This step appears under **Microsoft** in the step picker, not under **Research**.
* The editor does not show language, result count, or fallback controls for this step.
* If you need the exact returned fields for later references, run the step once and inspect the variable picker.

See also: [Creating and Editing](https://docs.fetchhive.com/workflows/creating-and-editing), [Testing and Iteration](https://docs.fetchhive.com/workflows/testing-and-iteration), and [Error Handling](https://docs.fetchhive.com/workflows/error-handling)