---
title: Manage documents
description: >-
  Manage the smart document templates table (rename, default, edit, delete) and
  review documents on each user profile, including deletion rules and
  permissions.
sidebar:
  order: 7
---

**Managing documents** covers two places: the templates table on **Settings → Communication & Documents → Documents**, where you rename, set defaults, edit, and delete templates, and the **Documents** tab on each user profile, where generated documents live.

:::warning
A template that is still in use cannot be deleted. Remove its assignments, self-service documents, study contracts, exam legal documents, and certificate links first.
:::

## Why it matters

Templates pile up over the years. A tidy table with clear names and one default per purpose keeps staff from picking the wrong document. Knowing the delete rules avoids surprises.

## Before you start

| Requirement | Detail |
|---|---|
| **Feature** | **Smart Documents** in the FuxamCMS package. |
| **Permission** | `read-write:settings-service-contracts` for templates. `write:user-documents` to delete a document on a user profile. |
| **Where** | **Settings → Communication & Documents → Documents**. |

## The templates table

| Column | Meaning |
|---|---|
| **Name** | Template name. Use the search box above the table to find one. |
| **Object Type** | User, Module, Curriculum, Room, or Certificate. |
| **Form Fields** | How many fillable fields the template has. Zero means nothing to fill in. |
| **Default** | Marks the template preselected when you add a document. |
| ⋯ | Actions menu. |

The ⋯ menu offers **Edit**, **Rename**, **Set as Default** or **Remove as Default**, **Delete**, and **Time tracking settings**.

## How to manage templates

1. Go to **Settings → Communication & Documents → Documents**.

2. Find the template with the search box and open its ⋯ menu.

3. Choose **Edit** to open the editor, **Rename** to change the name, or **Set as Default** to preselect it.

4. To delete, choose **Delete**, type the template name when asked, and confirm in **Delete Template**.

If the template is still in use, you see "Cannot delete template". Remove the links named in the message and try again.

:::info
Legacy **PDF** templates appear in the same table. **Edit** opens the older PDF editor for them. Bulk download works only for PDF templates.
:::

## Documents on a user profile

Open **Campus Management → User Management → [User] → Documents**. The tab has these parts:

- **User Documents**: files uploaded by the user or added by staff.
- **Internal Documents**: staff-only files.
- **Requested Documents**: documents you asked the user to complete, with **Pending** or **Finished** status, **Assigned Date**, and **Completed Date**.
- Study contracts, certificates, and invoices in their own sections.

Use **Smart Document** to add a document from a template. Use **Request Completion from User** to ask the user to fill one in. Each row offers **Download**, **View**, and **Delete**. Deleting needs the permission `write:user-documents`.

## Best practices

- **Name for staff and year.**
- **Set a default** for your most used template.
- **Check Form Fields** before you request completion.
- **Rename instead of copying** when only the name changes.
- **Retire old templates** once nothing uses them.

## Common pitfalls

| Pitfall | How to avoid it |
|---|---|
| Delete refused | Remove assignments, self-service entries, contracts, legal documents, and certificate links first. |
| Wrong default | Use **Remove as Default** and set the right one. |
| Cannot delete a user document | Ask an admin with `write:user-documents`. |
| Editing a legacy PDF template in the wrong editor | PDF templates open the old editor. New work belongs in TipTap templates. |
| Similar names | Use clear names so pickers stay readable. |

## FAQ

**What does Default do?**

The template marked **Default** is preselected when you add a document to a user. Set the one you use most often.

**What does Rename change?**

It changes the template name shown in the templates table and in pickers.

**How do I see which version is live?**

Open the template in the editor and check **Versions**. The **Current** one is live.

**Can students save a document they generated themselves?**

Yes. In the self-service viewer they can download a copy or select **Save to documents**.

## Related pages

**[Edit a document](/docs/fuxam-web/cms/smart-documents/edit-a-document)**

Change a template.

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

Generate documents.

**[View a user](/docs/fuxam-web/base/user-management/view-a-user)**

The user profile.

**[Permissions and features](/docs/fuxam-web/settings/permissions-and-features)**

How features and permissions work.
