# Typograph

> Press-ready templates that people, your systems and AI agents personalise, within the limits you set

The Typograph documentation, for AI agents. Every page is listed below with its summary.
The full text of every page is at https://docs.typograph.nl/llms-full.txt, and https://docs.typograph.nl/docs-index.json holds it
cut into one entry per section. Connected to the Typograph MCP server (https://mcp.typograph.nl/mcp),
an agent searches and reads the same text with the tools docs_search and docs_get. Pages list
the MCP tools that do what they explain. The public API is described in OpenAPI at
https://docs.typograph.nl/openapi.yml.

## Portal: working in Typograph as a user

- [Portal Documentation](https://docs.typograph.nl/portal/): Welcome to the Typograph Portal user guide.
- [Managing Assets](https://docs.typograph.nl/portal/content/assets): "Assets" in Typograph covers two things, both scoped to a project: (MCP tools: media_list, media_get_urls, media_tag, tag_list, tag_rename, tag_delete, media_delete, font_list, font_update, font_get_urls, font_delete, upload_create, upload_process)
- [Documents vs Templates](https://docs.typograph.nl/portal/content/documents): A note on terminology before you dig in
- [Managing Templates](https://docs.typograph.nl/portal/content/templates): Templates are the primary content unit in Typograph. This page covers the lifecycle you'll use in the Portal. For the document JSON schema see the developer concepts. (MCP tools: template_list, template_get, template_create, template_update, template_delete, template_restore, premade_template_list, premade_template_get, premade_template_use, upload_create, upload_process, publisher_job_create)
- [Editor Overview](https://docs.typograph.nl/portal/editor/overview): The Editor opens whenever you create or click a template in the Portal. It's where you design — adding text, shapes, and images to your pages. This page gives you a tour of the layout before the other Editor guides walk through specific tools.
- [Managing Pages and Layers](https://docs.typograph.nl/portal/editor/pages-and-layers): Most templates have more than one page, and most pages have more than one overlapping element. This page covers organizing both.
- [Saving, Undo/Redo, and Exporting](https://docs.typograph.nl/portal/editor/saving-and-exporting): The last things to know before you're comfortable in the Editor day-to-day: how your work is saved, how to undo mistakes, and how to get your finished design out as a file.
- [Adding Shapes and Images](https://docs.typograph.nl/portal/editor/shapes-and-images): Shapes and images give your template visual structure — backgrounds, dividers, photos, and icons. This page covers adding and styling both.
- [Adding and Styling Text](https://docs.typograph.nl/portal/editor/text): Text boxes are one of the most common elements you'll add to a template. This page covers adding text, styling it, and reusing text snippets. See the Editor Overview if you haven't already toured the layout.
- [Signing In](https://docs.typograph.nl/portal/getting-started/login): Before you can use Typograph, you need to sign in to your account. Pick whichever login method matches your setup — Google, Microsoft, or email — and follow the steps below to reach the Portal.
- [Navigation](https://docs.typograph.nl/portal/getting-started/navigation): The Portal is organized around two primary navigation surfaces: the top bar for organization-wide tools and the left sidebar for your content and shortcuts.
- [Portal Overview](https://docs.typograph.nl/portal/getting-started/overview): The Typograph Portal is the web UI for designers and content operators. Everything you can do through the API is also reachable through the Portal, plus collaborative affordances like sharing, invites, comments, favorites, and trash.
- [Apps](https://docs.typograph.nl/portal/organization/apps): An App connects an outside tool or a piece of software your organization uses to Typograph, so it can work with your projects and templates on your behalf. You'll need one before connecting anything external — a custom integration, an internal tool, or a webhook. (MCP tools: app_list, app_get, app_logo_upload, app_logo_delete, scope_list)
- [AI Assistant Settings](https://docs.typograph.nl/portal/organization/assistant): What the portal's AI assistant may do in your organization — read and edit, read only, or off — which AI provider processes what it reads, and whether guests may use your AI credits. (MCP tools: organization_assistant_get, organization_assistant_update)
- [Subscription & Usage](https://docs.typograph.nl/portal/organization/billing): Every organization is on a plan — Free, Pro, or Enterprise — that determines how much you can use Typograph before hitting a limit. (MCP tools: subscription_plan_list, subscription_plan_get)
- [Creating an Organization](https://docs.typograph.nl/portal/organization/create-organization): Create another organization for another company or a client, with its own members, apps, subscription and billing. (MCP tools: organization_create)
- [Deleting an Organization](https://docs.typograph.nl/portal/organization/delete-organization): The owner of an organization can delete it. You confirm it with a code we email you, so nobody deletes an organization without access to the owner's mailbox. You cannot undo it yourself. Deleted it by mistake? Support can restore it within 30 days; after that its teams, projects, templates and files are deleted for good. (MCP tools: organization_deletion_code, organization_delete)
- [Apps of Guests](https://docs.typograph.nl/portal/organization/guest-apps): People from other organizations can work in your teams. In Typograph they are guests: they have a role in one of your teams, but they are not members of your organization. The portal shows them your teams under your organization's name. (MCP tools: organization_guest_apps_get, organization_guest_apps_update)
- [Invites](https://docs.typograph.nl/portal/organization/invites): You can grant access to your work at three different levels — organization, team, and project — and they don't have to match. A single template can be shared too; that is covered in Managing Templates. Someone can be a full member of your organization with no access to a specific project, or the reverse: a guest with no organization role at all, invited into a single project. (MCP tools: organization_invitation_create, organization_invitation_list, organization_invitation_resend, organization_invitation_revoke, organization_invitation_list_mine, organization_invitation_accept, organization_invitation_decline, invitation_create, invitation_list_resource, invitation_list_my, invitation_accept, invitation_decline, invitation_delete)
- [Managing Members](https://docs.typograph.nl/portal/organization/members): The Members page lists everyone in your organization, with their organization role and when they joined. An owner or admin can invite someone with Invite, give a member another role, or remove them from the organization. (MCP tools: organization_member_list, organization_member_update_role, organization_member_remove)
- [Organization Structure](https://docs.typograph.nl/portal/organization/structure): Typograph organizes everything you create under a single hierarchy: Organization → Teams → Projects. Knowing how these three levels relate makes it much easier to find your way around sharing, roles, and billing. (MCP tools: organization_list, team_list, team_create, team_update, team_delete, project_list, project_create, project_update, project_delete)
- [Transferring Ownership](https://docs.typograph.nl/portal/organization/transfer-ownership): An organization has exactly one owner. Only the owner can manage the subscription and billing, and only the owner can delete the organization. When someone else should take that over, the owner hands the organization to another member. Ownership cannot be shared, and no admin can give it out: the owner is the only person who can transfer it. (MCP tools: organization_transfer_ownership)
- [Webhooks](https://docs.typograph.nl/portal/organization/webhooks): A webhook lets Typograph notify another system the moment something happens here — a template published, a project shared, and so on — instead of that system having to keep checking for updates. You'll need at least one App first, since every webhook is attached to one. (MCP tools: webhook_list, webhook_get, webhook_create, webhook_update, webhook_delete, webhook_list_deliveries, webhook_retry_delivery, webhook_list_event_types)
- [Permissions](https://docs.typograph.nl/portal/users/permissions): Permissions in Typograph are resource-scoped. Every action checks the role you hold on the specific resource you're touching — team, project, or template — not a single global role per user. (MCP tools: permission_get, role_list, role_update, role_delete, access_request_create, access_request_list, access_request_approve, access_request_decline, access_request_withdraw)
- [User Roles](https://docs.typograph.nl/portal/users/roles): Typograph assigns roles at two levels:
- [Account Settings](https://docs.typograph.nl/portal/workspace/account): Updating Your Profile (MCP tools: identity_whoami, identity_profile_update, identity_account_deletion_code, identity_account_delete)
- [Assistant](https://docs.typograph.nl/portal/workspace/assistant): Ask the portal's AI assistant how something works, let it find your work in all your organizations, and let it make changes for you after a plan you approve; which organization's AI credits a turn uses, and its limits.
- [When the Assistant Is Wrong](https://docs.typograph.nl/portal/workspace/assistant-mistakes): Why the portal's AI assistant can give a wrong or misleading answer, how to check an answer, and what to do when one is wrong.
- [Favorites](https://docs.typograph.nl/portal/workspace/favorites): Click the heart on a project or template to pin it under Favorites in the sidebar, so it's one click away instead of buried a few levels down the hierarchy. (MCP tools: favorite_list, favorite_toggle)
- [Notifications](https://docs.typograph.nl/portal/workspace/notifications): Typograph notifies you about activity relevant to you — mentions, invites, requests for access and their answers, and other updates on things you have access to. (MCP tools: notification_list, notification_mark_read, notification_mark_unread, notification_mark_all_read)
- [Search](https://docs.typograph.nl/portal/workspace/search): Search finds the templates, projects, teams, media and fonts you can open, by name, from anywhere in the Portal. (MCP tools: search, recent_searches, recent_templates)
- [Trash](https://docs.typograph.nl/portal/workspace/trash): Deleting a team, project, template, clip, media file, or font doesn't remove it right away — it moves to the trash first, where it stays recoverable for 30 days before being purged for good. (MCP tools: trash_list, template_restore, project_restore, team_restore, media_restore, font_restore, clip_restore)

## Webshop back office: for shopkeepers

- [Webshop Back Office](https://docs.typograph.nl/shop/): A guide to the back office of a Typograph webshop, for the people who run the shop
- [Building the Catalogue](https://docs.typograph.nl/shop/catalogue/building): Add Typograph designs to the webshop, set prices, make products orderable, and arrange categories and filters
- [Design Changes and Notifications](https://docs.typograph.nl/shop/catalogue/design-changes): Approve new versions of a design, answer notifications about broken designs, and how the nightly check works
- [Your Account and Roles](https://docs.typograph.nl/shop/getting-started/account): Getting into the webshop back office, the four roles, how the owner hands them out, and usage analytics
- [Handling Orders](https://docs.typograph.nl/shop/orders): Find an order in the webshop back office, read its lines and addresses, and move it from new to shipped
- [Connection](https://docs.typograph.nl/shop/settings/connection): Link the webshop to your Typograph organisation, choose its projects, set up notifications, and manage the shop key for your website
- [Print files](https://docs.typograph.nl/shop/settings/print-files): Choose whether customers can download the print-ready PDF of their order before it is paid

## Developer guides: the API, the widgets and the MCP server

- [Introduction](https://docs.typograph.nl/guides/): Welcome to the Typograph Developer Documentation.
- [Authentication](https://docs.typograph.nl/guides/api/authentication): OAuth 2.0 authentication for the Typograph API
- [Converter Service](https://docs.typograph.nl/guides/api/converter): Convert InDesign and POD packages, PDFs, fonts, and images
- [Document Service](https://docs.typograph.nl/guides/api/document): Validate and upgrade Typograph templates against the current schema
- [File Service](https://docs.typograph.nl/guides/api/file-service): Teams, projects, templates, media, fonts, sharing
- [Identity Service](https://docs.typograph.nl/guides/api/identity-service): Current user, deleting your own account, organizations, members, apps and their logos, connected apps, the apps of guests, the assistant, and scopes
- [AI Agents](https://docs.typograph.nl/guides/api/mcp-server): Connect AI agents to Typograph using the Model Context Protocol (MCP)
- [API Overview](https://docs.typograph.nl/guides/api/overview): Introduction to the Typograph API
- [Pagination](https://docs.typograph.nl/guides/api/pagination): How to paginate list endpoints in the Typograph API
- [PDF Output Options](https://docs.typograph.nl/guides/api/pdf-options): Every option a publisher job takes in output.config, with the exact syntax
- [Publisher Service](https://docs.typograph.nl/guides/api/publisher): Generate PDFs and images from Typograph templates
- [Rate Limiting](https://docs.typograph.nl/guides/api/rate-limiting): API rate limits, tiers, categories, and best practices for handling throttling
- [Renamed fields and paths](https://docs.typograph.nl/guides/api/renamed-names): The API, webhook, MCP and webshop names that changed when Typograph moved to one naming convention, old to new
- [Scopes](https://docs.typograph.nl/guides/api/scopes): API permission scopes for the Typograph API
- [Token Types](https://docs.typograph.nl/guides/api/token-types): Understanding user tokens vs client tokens in the Typograph API
- [Headers for the URLs of a job](https://docs.typograph.nl/guides/api/url-headers): Send authentication headers with every request a publisher or converter job makes, with url_headers
- [Webhooks](https://docs.typograph.nl/guides/api/webhooks): Receive real-time notifications and manage webhook subscriptions
- [Documents](https://docs.typograph.nl/guides/concepts/documents): A Typograph document (also called a template when saved in the file service) is the versioned JSON structure that the editor reads, the validator checks, and the publisher renders. This page covers the top-level shape; the remaining pages in this section zoom in on pages, elements, and swatches.
- [Elements](https://docs.typograph.nl/guides/concepts/elements): A page element is anything that appears on a page — a text block, an image, a shape, a table, a group. All elements share a common set of baseline properties (identity, geometry, fill, stroke, shadow, opacity, blend mode). The type field on every element determines which additional, type-specific fields are present.
- [Pages](https://docs.typograph.nl/guides/concepts/pages): A Typograph document lays its pages out in spreads. A spread is the container: it holds one or more page records side by side, and every element on those pages, in one coordinate space. A single page is a spread with one page record; a facing pair is a spread with two. See Elements for element-level detail.
- [Styles, Swatches & Fonts](https://docs.typograph.nl/guides/concepts/styles): Typograph does not use a traditional "paragraph/character/object styles" system where styles are defined globally and applied by name. Instead, visual style is expressed two ways:
- [Configuration](https://docs.typograph.nl/guides/getting-started/configuration): The Editor and Viewer are CDN-hosted browser scripts. Each is constructed with a container and a small options object, and then configured through host providers passed at construction and DOM events on a window.typograph global. This page covers the most common patterns; the full walkthrough lives on the dedicated integration pages.
- [Installation](https://docs.typograph.nl/guides/getting-started/installation): There are two ways to integrate with Typograph, and most real integrations combine them:
- [Quick Start](https://docs.typograph.nl/guides/getting-started/quick-start): This walkthrough takes you from "I have a clientid/clientsecret" to a successful API call in a few minutes. It uses the Client Credentials flow, which is appropriate for server-to-server work. If you're building a user-facing app, use Authorization Code with PKCE instead.
- [Editor Integration](https://docs.typograph.nl/guides/integration/editor): The Typograph Editor is a full browser-based document editor, delivered as a CDN-hosted script. It builds its own chrome — menu bar, toolbar, content bar, parameter bar — and exposes a window.typograph global for wiring up loading, saving, and the image/font manifest.
- [Form Integration](https://docs.typograph.nl/guides/integration/form): The Typograph Form Widget turns a form you designed in the portal into a fillable form on
- [Templates](https://docs.typograph.nl/guides/integration/templates): Templates are the reusable design files in Typograph — created in the Editor, stored in the File Service, rendered by the Publisher. This page covers the API surface around them; see Concepts → Documents for the underlying JSON schema.
- [Viewer Integration](https://docs.typograph.nl/guides/integration/viewer): The Typograph Viewer fills templates in. It is the read-only counterpart of the Editor — same rendering engine, same bundle family, a much smaller interface: no menu bar, no parameter bar, and a floating toolbar that follows whatever is selected.
- [Support](https://docs.typograph.nl/guides/support): Get help with Typograph - contact support, resources, and community
- [Catalogue](https://docs.typograph.nl/guides/webshop/catalogue): Read a webshop's products, categories, filters, search results and delivery options
- [Customers](https://docs.typograph.nl/guides/webshop/customers): Optional customer accounts on a webshop — sign-up, sign-in, a shortlist and order history
- [Personalise and Order](https://docs.typograph.nl/guides/webshop/orders): Fill in a product with the form widget, keep the cart in the browser, upload the pictures and place the order
- [Webshop API](https://docs.typograph.nl/guides/webshop/overview): Build your own storefront on a Typograph webshop — the shop key, allowed websites, response shapes, errors and limits