Editor handbook

Everything you need as a writer or editor. No Git, no jargon — you write, PullPress takes care of saving, reviews and history behind the scenes.

This handbook is for the people who create content. If you set sites up, connect repositories or define content models, see the administrator guides instead. Use the guides below — or the navigation on the left — to jump to a task.

Writing & formattingThe editor, the “/” menu, links, and clean Markdown.Images & mediaUpload, drag & drop, the media library, stock photos and AI images.Structured contentForms, lists, dates, relations and SEO fields.Saving & publishingDrafts, submitting, publishing, autosave, history and bulk actions.Reviewing & teamworkDiffs, comments, @mentions, approvals and the AI helpers.Planning & calendarThe content board, collecting ideas, and the editorial calendar.Multiple languagesTranslating entries and keeping them in sync.iPhone, iPad and MacWrite, add photos, review and get notified from the Apple app (beta via TestFlight, coming soon to the App Store).Shortcuts & FAQKeyboard shortcuts, search, appearance and common questions.

You don't need a GitHub account or a password. Your invitation email contains a personal sign-in link: click it, press Sign in and get started and you're in, straight on the site you were invited to. That link works once and stays valid for seven days — don't forward it. If it has expired or was already used, the page lets you request a fresh sign-in email.

After that first time, sign in on the login page: enter your email address and PullPress emails you a sign-in link that's valid for ten minutes. Click it and you're in. The same email also carries a six-digit code: reading your mail on your phone while you work on a laptop? Type the code on the login page instead, and the laptop signs in. You then stay signed in for 30 days (counted from the last time you used PullPress), so regular editors rarely see the login page.

If you work on just one site, PullPress opens that site straight away after signing in — no overview page to click through.

Didn't get the email? Check your spam folder, make sure you typed the same address your administrator invited, and try again — links are single-use, so always click the most recent one.

The PullPress login page: a single email field and a button that sends a sign-in link — No passwords: enter your email and click the link you receive.

The first time you open a site you were invited to, a short welcome panel explains the whole job in three lines: write, submit, and someone on the team puts it online. Click “Got it, don't show this again” when you no longer need it.

A site page with the panel “Welcome! Here's how writing for Harbor Bakery works”, listing the three steps write, submit, it goes live, above the site's collections and the writer's own changes with status badges — Invited writers land on their site with a short “how this works” panel.

Your dashboard

After signing in you land on your dashboard. The “Needs your attention” panel at the top gathers everything waiting on you, so you rarely have to go looking:

The PullPress dashboard: a “Needs your attention” panel with a change waiting for approval, site cards, and a “Recent changes” list with status badges such as Publishing…, Waiting for approval, Draft and Published — The dashboard: what needs you, your sites, and recent changes with their status.

To rework — changes an approver sent back, with their note and a button to reopen and fix them.
Continue writing — drafts you started but haven't submitted yet.
Waiting for your approval — if you can publish, the changes other people submitted to you.
Scheduled — approved changes set to go live later.
You were mentioned — comments where a colleague @mentioned you.

From the top bar you can switch workspaces (if you belong to more than one), open a site, jump anywhere with the command palette (⌘/Ctrl + K), check your notifications under the bell, and open your account menu (the round button with your initials) for your profile, the keyboard shortcuts, help, the theme and logging out. On a phone all of this sits in the menu. On your profile you pick your language (emails follow it too), choose which notification emails you get, download a copy of your data, or delete your account.

Your profile

Click your name in the top bar to open My profile. From top to bottom you'll find:

Name — how you appear on your changes, in comments and in the change history.
Sessions — signed in on a shared or lost device? Log out everywhere else signs out every other browser and device; only the one you're using stays signed in.
Language — the language of the app (and of the emails PullPress sends you).
Field help — how the help text on form fields appears: Compact (an ⓘ icon you hover or tap) or Always visible under the field.
Email notifications, API tokens and Connected apps for AI assistants (see AI & assistants), and Your data — all explained below.

My profile: your name, sessions, language and how field help is shown.

Email notifications

PullPress emails you when something needs you or concerns your work. Under Email notifications on your profile you can switch each kind on or off:

Review requests — someone submitted a change you can approve.
Updates on my changes — your change was published or sent back, or its scheduled publish was cancelled.
Comments and mentions — new comments on changes you're part of, and when a colleague @mentions you.

Every such email also ends with an unsubscribe link for its kind — no need to sign in. The page it opens asks you to confirm with one button (so a company mail filter that opens links can't unsubscribe you by accident), and afterwards lets you undo it. Sign-in links, invitations and security alerts (for example “a new app was connected to your account”) are always sent. Your dashboard, the notification bell and the phone app keep showing everything either way. In the Apple app you find the same switches, and your language, under Account.

Notifications (the bell)

The bell in the top bar collects what happened for you, newest first: a change someone submitted for your review, a decision on your change (published, sent back, or a scheduled publish that was cancelled), and comments on changes you're part of — or a mention when a colleague @mentions or assigns you. A dot on the bell counts what you haven't read yet. Click an item to open it (that marks it read), or choose Mark all as read.

The bell always gets everything, whatever you chose under email notifications — those switches only decide about email. It's the web's counterpart of the push notifications in the Apple app. Items stay for 90 days, and items of a site you no longer have access to disappear from the list.

Switch each kind of notification email on or off.

Your data: export and delete your account

Open your profile (account menu, top right) and scroll to the bottom:

Download my data saves a JSON file with what PullPress keeps about you: your profile, workspace and site memberships, your API tokens (names and dates, never the tokens themselves), and the changes, comments and ideas you wrote.
Delete account asks you to type your email address, then removes your account, sign-ins, tokens, connected apps and devices for good. Changes, comments and ideas you wrote stay with your team without your name; content already published on your websites isn't touched. If you're the only member of a workspace, that workspace, its subscription and its billing record go too. If you're the only owner of a workspace that still has other people in it, make someone else owner first — the page tells you when that's needed.
Analytics settings (when analytics are enabled) lets you accept or withdraw usage analytics at any time.

Your changes are saved in the website's change history under your name. Unless your administrator chose otherwise for that site, that history shows an anonymous no-reply address, not your email address. You can also delete your account from the Apple app (see the Apple app).

Finding content

Open a site to see its collections — blog posts, pages, opening hours, team members, and whatever else your administrator set up. Inside a collection you can search and page through entries, and breadcrumbs (Site › Collection › Entry) always show where you are. To search across an entire site, use the search page; with AI enabled it also offers a semantic mode that finds content by meaning. See Shortcuts & FAQ for the details.