> For the complete documentation index, see [llms.txt](https://cortex-docs.paloaltonetworks.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cortex-docs.paloaltonetworks.com/cortex-xsoar-8-on-prem/8.9/configure-cortex-xsoar/playbooks/develop-your-playbook/task-1.-choose-from-out-of-the-box-playbooks-or-customize-your-own.md).

# Task 1. Choose from out-of-the-box playbooks or customize your own

You can use or customize an existing playbook or create a new playbook.

<details>

<summary>Use a playbook out-of-the-box or customize it</summary>

**Search for an out-of-the-box playbook**

Search for a playbook that is included out-of-the-box with Cortex XSOAR or after downloading from Marketplace.

In the Cortex XSOAR **Playbooks** page, use free text in the search box to search for playbooks. You can search using part or all of the playbooks' names or description. You can also search for an exact match of the playbook name by putting quotation marks around the search text. For example, searching for **`"Block Account - Generic"`** returns the playbook with that name.

Search for more than one exact match by including the logical operator "or" in-between your search texts in quotation marks. For example, searching for **`"Block Account - Generic" or "NGFW Scan"`** returns the two playbooks with those names. Wildcards are not supported in free text search.

{% hint style="info" %}

### Tip

You can also browse Marketplace to check for out-of-the-box playbooks that you can customize for your process. For an extensive list of available out-of-the-box playbooks, see [Generic Playbooks](https://xsoar.pan.dev/docs/playbooks/playbooks-generic).
{% endhint %}

**Customize an out-of-the-box playbook**

When installing a playbook from a content pack, by default, the playbook is attached, which means that it is not editable (apart from some input values).

To edit the playbook, you need to detach or make a duplicate. While it is detached, the playbook is not updated by the content pack. This may be useful when you want to update the playbook without breaking customization. If you want to update the playbook type through content pack updates, you need to reattach the playbook, but any changes are overridden by the content pack on upgrade. If you open an attached playbook in a tab, it can be detached from within the editor page.

If you want to keep the changes, duplicate the playbook before reattaching it.

</details>

<details>

<summary>Create a playbook</summary>

1. Go to **Playbooks** and click **+ New Playbook**.
2. Enter a name for the playbook and click **Save**.

   A blank playbook opens with the **Playbook Triggered** task that holds the playbook inputs and outputs.

{% hint style="info" %}

### Note

* To open multiple playbooks at the same time, edit the first playbook and then click **New** next to the playbook name to create a new tab. You can either create a new playbook, or add an existing one.
* You can view recently modified or deleted playbooks by clicking version history for all playbooks ![versionhistory.png](/files/gQJ7BiGQdujSRzY8nhQy).
  {% endhint %}

</details>

<details>

<summary>Navigate the playbook</summary>

You can easily navigate playbooks and focus on the parts you need to work on by collapsing and expanding playbook sections. Collapsing sections provides a condensed view of the playbook flow, reducing visual clutter and enabling quick access to specific sections. Expanding sections allows you to view or edit specific parts of a playbook while keeping the rest of the playbook compact and maintaining focus on the relevant playbook details. You can also hover over a Section Header to highlight all tasks under the section and easily identify the section scope.

To collapse and expand a section, in the **Playbooks** page, after selecting a playbook from the library or creating a new playbook and adding tasks, click ![playbook-expand-collapse.png](/files/nv1s6nGz3d74m87bR0Di) on a section header.

When you collapse a section, you can see the number of tasks included under the section. For example:

![playbook-collapsed-num-tasks.png](/files/DMRJ1wJo698FQkjekmBO)

Click ![playbook-collpase-expand-all.png](/files/FWZmtOYK5SB6jUtgBz8P) to collapse or expand the entire playbook.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://cortex-docs.paloaltonetworks.com/cortex-xsoar-8-on-prem/8.9/configure-cortex-xsoar/playbooks/develop-your-playbook/task-1.-choose-from-out-of-the-box-playbooks-or-customize-your-own.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
