---
title: Smart documents
description: >-
  Smart documents are templates for letters, contracts, and certificates written
  in the TipTap editor and filled with real data — managed in Settings and
  generated from user profiles, in bulk, or by self-service.
sidebar:
  order: 7
  label: Overview
---

**Smart documents** are templates for letters, contracts, and certificates that Fuxam fills with real data. You manage them on **Settings → Communication & Documents → Documents** and generate them from **Campus Management → User Management**.

:::tip
Start with [Create a document](/docs/fuxam-web/cms/smart-documents/create-a-document), then [Edit a document](/docs/fuxam-web/cms/smart-documents/edit-a-document). Preview with a real user before you use a template.
:::

## Why it matters

Official paperwork is repetitive and error-prone. With smart documents you write it once in a visual editor, insert variables for names, dates, and program data, and generate a correct version for each person. Changes are versioned, so you can see and restore earlier states.

## How this fits

Smart documents use data from [User Management](/docs/fuxam-web/base/user-management), [Study programs and cohorts](/docs/fuxam-web/cms/programs-and-planning/study-programs-cohorts), and [Time tracking](/docs/fuxam-web/cms/time-tracking). Students can see their self-service documents from the [Management tab](/docs/fuxam-web/lms/student-home/management-tab).

## Before you start

| Requirement | Detail |
|---|---|
| **Feature** | **Smart Documents** in the FuxamCMS package. See [Permissions and features](/docs/fuxam-web/settings/permissions-and-features). |
| **Permission** | `read-write:settings-service-contracts` to create, edit, and manage templates. |
| **Location** | **Settings → Communication & Documents → Documents**. The page title is "Smart Documents". |

## Key concepts

| Concept | Meaning |
|---|---|
| **Template** | A document design with text, variables, and form fields. |
| **Object Type** | The kind of record a template uses: User, Module, Curriculum, Room, or Certificate. |
| **Variable** | A placeholder replaced with real data when the document is generated. |
| **Form field** | An input someone fills in when completing the document. Counted in the **Form Fields** column. |
| **Version** | A saved, published state of a template. Visible under **Versions** in the editor. |
| **Default** | The template preselected when you add a document. |
| **PDF template** | An older template type. It still works and appears in the same table. New templates use the TipTap editor. |

## Ways to generate documents

| Route | Who | Where |
|---|---|---|
| **Single** | Staff | **Campus Management → User Management → [User] → Documents → Smart Document** |
| **Bulk** | Staff | Users table → **Smart Document** action |
| **Self-service** | Eligible users | Set up in the **Self-Service Documents** section |
| **Study contract** | Applicants | Assigned to application forms in **Study Contracts** |
| **Certificate** | Students | Certificate template chosen in the course |

## In this section

**[Create a document](/docs/fuxam-web/cms/smart-documents/create-a-document)**

Add a template, optionally from a Word file.

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

Use the editor, preview, and versions.

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

Generate for one user or through self-service.

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

What data fills a document.

**[Generate documents in bulk](/docs/fuxam-web/cms/smart-documents/generate-documents-in-bulk)**

Add a document to many users.

**[Study contracts and certificates](/docs/fuxam-web/cms/smart-documents/study-contracts-and-certificates)**

Contracts for applicants, certificates for students.

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

Templates table and user documents.

## Examples

Practical how-tos for typical documents:

**[Example: Create an enrollment certificate](/docs/fuxam-web/cms/smart-documents/examples/enrollment-certificate)**

A one-page User document.

**[Example: Create a course certificate](/docs/fuxam-web/cms/smart-documents/examples/certificate-zeugnis)**

A Certificate template used in a course.

**[Example: Create a transcript of records](/docs/fuxam-web/cms/smart-documents/examples/transcript-of-records)**

A grades table from the study plan.

**[Example: Create a module handbook (Modulhandbuch)](/docs/fuxam-web/cms/smart-documents/examples/module-handbook)**

A Module template for module description sheets.

## Who does what

| Role | Typical tasks |
|---|---|
| **Administrators** with `read-write:settings-service-contracts` | Create and edit templates, set defaults, configure self-service and study contracts. |
| **Registrars and staff** | Add documents to users, request completion, use the Smart Document action. |
| **Students and applicants** | Generate self-service documents, complete requested documents, sign contracts. |

## Data protection

Documents can contain personal data. Only insert variables the reader is allowed to see, limit self-service to the roles that need it, and restrict who can delete user documents (`write:user-documents`).

## Where to start

1. [Create a document](/docs/fuxam-web/cms/smart-documents/create-a-document).
2. [Edit a document](/docs/fuxam-web/cms/smart-documents/edit-a-document) and preview it.
3. [Use a document template](/docs/fuxam-web/cms/smart-documents/use-a-document-template).
4. For many users, read [Generate documents in bulk](/docs/fuxam-web/cms/smart-documents/generate-documents-in-bulk).
