Core concepts

PMKIN has a handful of building blocks. Learn these eight words and the rest of the app makes sense.

Teams#

A team is the people you work with, and the plan you're billed on. Everyone in a team can work in its projects. You can be in more than one team and switch between them from the project menu at the top of the sidebar.

Read more in members and invites and plans and billing.

Projects#

A project is one website or publication: your blog, your help center, your changelog. Each project has its own documents, categories, clusters and API keys, so a key for your blog can never read your help center.

Documents#

A document is one page: a blog post, a guide, a release note. It has:

• a title, and optionally a subtitle and a cover image,
• a body, written in the editor and stored as markdown,
• a slug, the last part of its URL, like quick-start,
• an excerpt, a short summary for lists of posts,
• a meta title and meta description for search results and link previews,
• a status, an assignee, a due date, a category and a cluster.

Statuses#

Every document has a status, which says how far along it is:

Status	What it means
Idea	Worth writing about. Usually just a title and a brief.
Planned	On the plan, with someone or a date in mind.
Drafting	Someone is writing it.
In review	Waiting for a reviewer to approve it or ask for changes.
Scheduled	Approved and set to publish at a date and time.
Published	Live on your website.

Change a status with the status menu at the top of the editor, or drag a card on the Board. Read more in statuses and workflow.

Briefs#

A brief says what a document should be: the search keyword it targets, the search intent, who it's for, how long it should be, an outline, notes, reference links and documents to link to. A document with a brief and no content yet is an idea.

Mark a brief ready and anyone on the team, or an AI agent, can claim it and write the draft. See briefs and ideas.

Categories#

Categories are for your readers. They become the sections of your website, like "Guides" or "News", and your site can list the documents in each one. A document has at most one category. See categories.

Clusters#

Clusters are for planning. A cluster is a topic and its keywords, with the documents that cover it and how many of them are live. Use them to see where a topic has gaps. A document belongs to at most one cluster. See topic clusters.

Tip: Not sure which to use? Categories answer "where does this go on the site?" Clusters answer "what are we trying to rank for?"

Draft and published#

Every document keeps two copies of its body:

• The draft is what you edit. It saves as you type.
• The published version is what your website gets.

Editing a published document doesn't change your website. The publish button reads Publish changes until you publish again. Until then, readers keep seeing the last published version.

Note: Details like the title, slug, excerpt and meta fields aren't part of the body. On a published document, changes to them go live right away.

Every change to the body is also kept in the document's history, so you can always go back. See revisions and history.