---
title: Generate documents in bulk
description: >-
  Add the same smart documents to many users at once from the Users table: pick
  up to 10 templates, merge or order them, choose the scope, then add them to
  the users or download a ZIP.
sidebar:
  order: 5
---

**Generating documents in bulk** means creating the same smart documents for many users at once. In the Users table under **Campus Management → User Management**, select users and use the **Smart Document** action.

:::info
Each document is filled with the user's data, saved as a finished PDF on the user's **Documents** tab, or downloaded as one ZIP file. Users are not notified.
:::

## Why it matters

Intakes and reporting periods create the same paperwork for hundreds of people. The bulk action saves you from repeating the single-user flow for each one. It only works well if templates are tested and user data is complete.

## Before you start

| Requirement | Detail |
|---|---|
| **Feature** | **Smart Documents** in the FuxamCMS package. |
| **Permission** | **Assigned documents** (manage) in your role, plus permission to edit the users. Without it, adding fails with an error. |
| **Tested template** | Try the template with one user first. |
| **Selection** | Select users, or filter the table so the right people are in it. |
| **Data quality** | Check that profiles hold the data the variables use. |

## How to add documents to many users

1. Open **Campus Management → User Management** and filter the table. Select the users, or keep the filter active for all matches.

2. Open the bulk actions and choose **Smart Document**. A sheet titled **Smart Document** opens: "Select the smart document template and choose an action to perform."

3. Under **Smart Document Selection**, click **Select Template**. Search or scroll, tick one or more templates (up to 10) and click **Add (N)**. Templates are grouped by document type.

4. Check the list. Drag a row to change the order, change a row's template or version in its picker, remove a row, or click **Add document** for another one.

5. With two or more templates, tick **Merge templates** to combine them into one PDF per user, in the order shown. Leave it off to get one PDF per template.

6. Under **Add scope**, choose **Add to selected users (N)** or **Add to all filtered users (N)**.

7. Optional: under **File name addition**, pick a custom field. Its value is added after the user's name, for example "Jane Doe [Student ID] Certificate.pdf".

8. Click **Add Document to User(s)**. The message "Successfully added document for N user(s)." confirms it and the sheet closes.

### Download instead of adding

Follow steps 1 to 7, optionally enter a **Zip file name** (it is prefilled with the study program of the chosen users; without one the file is called "smart-documents-export"), then click **Download Documents**. The ZIP downloads and "Successfully generated N document(s)." appears. Nothing is saved to the users' **Documents** tabs.

:::tip
To have people fill in a document themselves, open the user's **Documents** tab and use **Request Completion from User**. See [Use a document template](/docs/fuxam-web/cms/smart-documents/use-a-document-template).
:::

## Best practices

- **Test with one user first.**
- **Check the count** in the scope options before you confirm.
- **Use filters, not manual selection**, for large groups, then choose **Add to all filtered users**.
- **Fix data first.** Missing profile data produces empty values in every document.
- **Use a file name addition** such as a student ID when names repeat.

## Common pitfalls

| Pitfall | What happens | What to do |
|---|---|---|
| Selected instead of all filtered | Only part of the group gets the document. | Read the scope labels and their counts. |
| No templates in the picker | "No Smart Documents" appears in the sheet. | Create or publish a smart document template first. |
| **Merge templates** missing | Only one template is in the list. | Add a second template; the checkbox appears with two or more. |
| Missing permission | "Failed to request document completions, please try again later." | Ask an admin for **Assigned documents** in your role. |
| Untested template | Every PDF has the same mistake. | Preview and test with one user before a big run. |

## FAQ

**Where do the documents go?**

After **Add Document to User(s)**, they appear on each user's **Documents** tab. See [Manage documents](/docs/fuxam-web/cms/smart-documents/manage-documents). **Download Documents** only creates the ZIP.

**Can I undo a bulk add?**

Documents can be removed on the user's **Documents** tab one at a time. Check the templates and scope before you confirm.

**How many templates can I add at once?**

Up to 10 per run. Each template can be in the list only once.

**Do users get a notification?**

No. Bulk-added documents are saved as finished PDFs without a notification.

## Related pages

**[Use a document template](/docs/fuxam-web/cms/smart-documents/use-a-document-template)**

Single-user flow and self-service.

**[Bulk actions](/docs/fuxam-web/base/user-management/bulk-actions)**

Other actions in the Users table.

**[Manage documents](/docs/fuxam-web/cms/smart-documents/manage-documents)**

Where documents appear.

**[Document variables and data sources](/docs/fuxam-web/cms/smart-documents/document-variables-and-data-sources)**

Data quality for variables.

