Manage documents
Manage the smart document templates table (rename, default, edit, delete) and review documents on each user profile, including deletion rules and permissions.
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.
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
Go to Settings → Communication & Documents → Documents.
Find the template with the search box and open its ⋯ menu.
Choose Edit to open the editor, Rename to change the name, or Set as Default to preselect it.
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.
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.