Documents vs Templates
A note on terminology before you dig in: Typograph's primary content unit is the template. The word "document" is used more loosely, and the two relate like this:
- A template is the versioned design file you create in the Editor, store in a project, and render with the Publisher. Templates have UUIDs, permissions, comments, invites — all the collaborative machinery.
- A document is the output of running a template through the Publisher (a PDF, image, or set of images), or the JSON payload the API validates via the Document Service.
There is no separate "documents" section in the Portal. If you want to:
- Create new design content → create a template inside a project.
- Generate a PDF or image from a template → that's a publisher job, triggered from the template's menu or via the API.
- Upload images or fonts → those go under the project as media / assets.
Why This Matters
If you're used to tools where "documents" and "templates" are separate things (one is the reusable structure, the other is the filled-in instance), Typograph collapses that distinction: you always work with templates. When you need a one-off variant, duplicate the template. When you need a batch of filled-in instances, run a publisher job with a CSV of data.
Actions on a Template
From the template list or the Editor, you can:
| Action | What it does |
|---|---|
| Edit | Open in Editor |
| Duplicate | Create a copy inside the same project |
| Move | Move to another project (or team) |
| Invite | Share with a specific person and role |
| Favorite (star icon) | Add to Favos for quick access |
| Comment | Attach a comment to the template |
| Export / Publish | Trigger a publisher job (PDF / image) |
| Delete | Move to Trash (restorable) |
| Restore | Available from your account Trash |
API Equivalents
| Portal action | API endpoint |
|---|---|
| Create template | POST /v1/file/templates or POST /v1/file/projects/{id}/templates |
| Edit (autosave) | PATCH /v1/file/templates/{id} |
| Render to PDF | POST /v1/publisher/jobs |
| Validate schema | POST /v1/document/validate |
See File Service and Publisher in the developer docs for full details.