> For the complete documentation index, see [llms.txt](https://help.rhythms.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.rhythms.ai/documents-and-library/playbooks-that-create-or-refresh-documents.md).

# Playbooks that create or refresh documents

How playbooks generate documents from templates, where to see a document's playbook, and what to check before changing a template.

Many recurring documents in Rhythms are produced by a [playbook](https://help.rhythms.ai/playbooks/create-and-run-a-playbook.md). The playbook runs on a schedule, reads your OKRs and connectors, and writes the result into a document, usually one built from a [template](https://help.rhythms.ai/documents-and-library/templates-in-rhythms.md).

## Two kinds of document playbook

* **Refresh in place.** The playbook regenerates the same document on a cadence. The link never changes.
* **A new copy each period.** The playbook creates a fresh document from the template each week, fortnight or month, locks the previous copy, and keeps a series index that lists every copy.

A copy-each-period series takes its structure from the template each time a new copy is created, so it depends on the template for as long as it runs; only the structure is inherited, never the content. See [Keep a document up to date automatically](https://help.rhythms.ai/documents-and-library/keep-a-document-up-to-date-automatically.md) for how each works.

## See which playbook runs a document

1. Open the document.
2. Click the **Info** icon in the toolbar to open the Info pane (it is titled **About**).
3. Scroll to **Playbooks on this document**. Each card names the playbook, shows whether it is enabled, its schedule and its last run, and links to it.

![The Info pane of a document, with the Playbooks on this document section showing an enabled Document refresh playbook](https://4039886202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGNgNGJOnocLzqT0TwtU%2Fuploads%2FyhYlY2lu5bVvxfGiD2X9%2Fdocument-about-pane-playbooks.png?alt=media)

To find every document a playbook has produced, open the playbook and check **Run history** on its **Overview** tab.

## Find the playbooks that use a template

Rhythms does not currently list a template's dependent playbooks in one place, and the document count shown under **Settings › Workspace › Templates** is not a list of playbooks. To find them:

1. In the Library's Documents view, add the **Template** filter and pick the template to list the documents created from it.
2. Open each recent document's Info pane and note the playbooks under **Playbooks on this document**.
3. Open each playbook's **Configuration** tab and read its **Instructions** for references to the template.

If you are unsure, ask the playbook owner or [Rhythms Support](mailto:support@rhythms.ai).

## Before you change or retire a template

* **Editing a template** affects documents created after the change, including the next copy a playbook creates.
* **Deactivating a template** keeps existing documents, but it hides the template from the Library and from the assistant's template search, so a playbook that finds its template by name no longer finds it. Rhythms does not stop you from deactivating a template that a playbook uses, so check first.
* **Deleting a template** is permanent: there is no trash or restore for templates.

Update each dependent playbook to use an active replacement, or disable it, before you retire the template. See [Deactivate and reactivate a template](https://help.rhythms.ai/documents-and-library/deactivate-and-reactivate-a-template.md).

## If a run fails

Open the playbook's **Overview → Run history**, select the failed run and click **Review and fix**. If the template was deactivated, reactivate it or update the playbook to use a replacement, then run it again.

## Related articles

* [Templates in Rhythms](https://help.rhythms.ai/documents-and-library/templates-in-rhythms.md)
* [Keep a document up to date automatically](https://help.rhythms.ai/documents-and-library/keep-a-document-up-to-date-automatically.md)
* [Create and run a playbook](https://help.rhythms.ai/playbooks/create-and-run-a-playbook.md)
* [Deactivate and reactivate a template](https://help.rhythms.ai/documents-and-library/deactivate-and-reactivate-a-template.md)


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.rhythms.ai/documents-and-library/playbooks-that-create-or-refresh-documents.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
