Research OS for medical & scientific research teams
Welcome to CoPub. This guide walks you through every feature of the platform, from creating your account to publishing a manuscript — writing and citations, references and your library, tasks and files, team chat and meetings, the smart lab notebook, the AI assistant, your account and billing settings, and the administrator panel. Nothing is skipped: if it's a button in the app, it's explained here.
CoPub is bilingual — the entire interface works in English and Arabic, and in Arabic it flips to a full right-to-left layout automatically. It's built to keep your research private and compliant by design, with AI processing kept in-region.
A note on what you'll see: CoPub is organised into workspaces (organisations) and projects. Every feature described in this guide is switched on by default — you should not have to ask anyone to turn anything on. Your administrator can switch an individual feature off for the whole workspace, so if this guide mentions something you genuinely cannot find, that is the first thing to check (see The Admin Panel).
Being switched on is not the same as being configured. AI features additionally need your workspace's AI service credentials to be in place. If a button is visible but every AI action returns an error, that is the second thing to check — and it is an administrator or operator fix, not something you can resolve from your account.
How this guide is organised#
- Getting Started — accounts, sign-in, the dashboard, and creating projects
- The Manuscript Editor — writing, formatting, co-editing, versions, and exporting
- Citations & Reference Styles — inserting citations and the eight built-in styles
- References & Importing — building your reference list from anywhere
- Research Library & My Library — organising papers and reading with AI
- Tasks & Files — the project board and shared file storage
- Communication — Team Chat — messages, channels, voice notes, and search
- Meeting Minutes — structured minutes with AI transcription
- Smart Lab Notebook — capture ideas, images, links, and voice with AI
- Comments & Sharing Documents — feedback, external share links, and publishing a snapshot
- Learning hub — built-in tutorials that walk you through the platform
- The AI Assistant Suite — every AI feature, and how usage works
- Your Account, Billing & Settings — profile, security, plans, and language
- The Admin Panel — for workspace administrators
Tip — changing the language: You can switch the interface between English and العربية (Arabic) from your profile settings (see Your Account, Billing & Settings). CoPub also follows your browser's language on your first visit. In Arabic, menus, text, and layout mirror to right-to-left.
Tip — staying informed: A bell icon in the top bar shows your notifications — new comments, replies, mentions, shared entries, task assignments, and more. Click it for a quick preview, or open Notifications from your account menu to see everything and manage exactly which events email you (see Your Account, Billing & Settings → Notifications).
What's new (2026-07-19 release)#
This release deepens reviewing, sharing, and learning.
Reviewing (The AI Assistant Suite → AI review)
- A hub of review lenses. Run Full review, Proofread, Claim confidence, Peer assessment, Peer review or Source quality independently — each streams a live X of N sections counter and keeps running if you navigate away, with a notification when it finishes. Source quality checks your references against retraction signals and costs no AI credits.
- Review Mode. Walk a run's suggestions right in the document: the editor locks, Y accepts, N rejects, arrows navigate, Esc exits — and an accept re-checks the target text is still in place before applying it.
- Run history & a peer-review scorecard you can reopen and download, plus a 👍/👎 "What was good?" note on any suggestion.
Sharing & publishing (Comments & Sharing Documents → Publishing a document)
- One Share modal with Share and Publish tabs — invite members, manage collaborators, and create share links (view / comment / edit) in one place. Edit links grant real, authenticated membership when claimed (secret + expiry, revocable).
- Publish a read-only snapshot. With publishing enabled for your workspace, a pre-publish checklist (co-author confirmation, no unresolved review flags, sign-off) gates a stable public page; Unpublish is instant. Published pages are not search-indexed by default.
Learning (Learning hub)
- A built-in learning hub — short, practical tutorials with real-app screenshots, reachable from your dashboard, the editor's onboarding panel, and the Learn CoPub link in your account menu; your progress is tracked.
What's new (2026-07-12 release)#
This release brings CoPub to full feature parity with leading AI research-writing tools. Everything below is described in depth in the section named in italics.
Writing & the AI assistant (The Manuscript Editor, The AI Assistant Suite)
- AI drafts one section at a time. Draft a section from the Section Prompts panel with its Generate button, then accept or discard what it wrote. (Drafts never invent citations — you add those from your library, so nothing is fabricated.) (Until 13 November 2026 CoPub could also write the opening prose under every heading of a new document; that "full draft" option has been retired, and a new document now starts with headings only.)
- A smarter autocomplete bar. The grey ghost-text suggestion now shows on-screen buttons:
Accept, +Word (accept one word), ‹ › to cycle earlier suggestions, ↻ for a fresh
one, and ✨ Refine with presets (Stay on topic · Increase novelty · Simplify · No citations)
or your own instruction. Keyboard:
Tabaccept ·Alt+→one word ·Shift+←/→cycle ·Shift+Tabnew ·⌘/(Ctrl+/) call a suggestion on demand. - Richer AI edits. Selecting text and choosing AI edit now offers a free-form custom instruction, an Insert below option (keep the original, add the edited copy), and Try again. Citations inside the selection are always preserved through the edit.
- Editor conveniences. Hover any block for a gutter to add a block below, drag to move,
or AI-edit that block. The keyboard-shortcuts window now has Markdown and Math
reference tabs, and
⌘S/⌘Jare bound as shown.
AI chat (The AI Assistant Suite)
- Conversations you can manage: start a New chat, browse your history, and switch between threads. Every AI answer now has Copy and Add to document buttons.
- Bring context in: type in the composer's @ Source picker to mention a specific library paper, or / Prompt to insert a saved prompt. Highlight text in your document and choose Chat to quote it straight into the assistant.
Reviews (The AI Assistant Suite → Review)
- Run reviews independently: the review panel is now a hub — run Full, Proofread, Claim confidence, or Peer assessment on their own, and tick "Review the selected passage only" to scope a review to a highlight.
- Accept fixes inline: proofread suggestions have an Accept button that applies the change to your document.
- A fuller assessment: an Overall score /10 plus Weaknesses, Strengths, and Questions for the authors. Weakly-supported claims now suggest possible supporting sources.
- Tone matching can now match the style of one of your own library papers, not just a preset.
References & library (References & Importing, Research Library & My Library, Citations & Reference Styles)
- Turn a PDF into a source: upload a PDF and CoPub reads it, looks up its DOI metadata, creates the source, and attaches the file — all in one step.
- Look up by ISBN in the identifier box (alongside DOI/PMID).
- Better discovery: search results show an abstract with See more, plus Sort (relevance / newest / most cited) and an Open-access-only filter, and you can file a result straight into a collection as you add it.
- Per-document citation style: override the citation style for a single document (it inherits the project default otherwise), and limit citations to a collection.
- Export your library as CSV (beside
.bib/.ris), and Copy the whole document to your clipboard from the editor.
Comments & collaboration (Comments & Sharing Documents)
- React to comments with emoji, and sort/filter the comments panel (Oldest/Newest · All/Open/Resolved).
Account & app (Your Account, Billing & Settings)
- Some AI tools have their own monthly limit, separate from credits. On the free tier you get 2 AI reviews, 25 literature searches, 10 discovery summaries, 5 grounded generations and 30 minutes of voice transcription per period. These stop you before your credits do, and they stop hard rather than degrading — so if AI review refuses while you still have credits showing, this is why. Paid tiers raise every one of these.
- AI credits replenish monthly to your plan level, and the AI-usage page shows the next reset date; if you hit the cap you'll now see a clear notice.
- Install CoPub as an app — Chrome (and other browsers) offer an Install option, and there are User guide + Terminology glossary links right in your account menu.
Getting Started — accounts, sign-in, dashboard, projects#
Welcome to CoPub (Research OS). This section walks you through everything you need to get up and running: creating your account, verifying your email, signing in with your email and password, recovering a lost password, finding your way around the dashboard, creating your first research project, understanding team roles, and inviting collaborators. CoPub works fully in English and Arabic — if you switch to Arabic, the whole interface flips to right-to-left automatically.
Note: AI features are on by default. Signing in with a Google, Microsoft or institutional account is not offered — you sign in with your email and password.
Creating your account with email and password#
You can sign up in a minute with just an email address and a password.
- Go to the Create your account page (the sign-up screen).
- Fill in the Email field — this is required and becomes your sign-in name.
- Optionally add your Full name — you can leave this blank and set it later.
- Choose a Password. Your password must be at least 12 characters and include a lowercase letter, an uppercase letter, and a digit. CoPub checks this as you type and shows a red message if something's missing.
- Click Sign up.
If the email you entered already belongs to an account, the form tells you inline ("is already registered") instead of creating a duplicate — in that case, head to sign-in or reset your password.
Tip: Already have an account? The sign-up page has a Sign in link at the bottom that takes you straight to the login screen.
Verifying your email (the 24-hour link)#
For security, a brand-new email-and-password account has to confirm it owns the address before it can sign in.
- Right after you sign up, CoPub emails you a verification link.
- Open that email and click the link. This confirms your address and unlocks sign-in.
- The link is valid for 24 hours and can only be used once. After that (or if you never received it), you'll need a fresh one.
If you try to sign in before verifying, the sign-in page shows an amber notice: "Verify your email to sign in." It has a Send verification email button — click it to receive a new link.
Note: You can request up to 5 verification emails per 24 hours. If you run out, please contact support@nomialab.com and we'll help.
Signing in with email and password#
- Open the Sign in page.
- Enter your Email and Password.
- Click Sign in.
Two handy links sit just below the form: Forgot password? and Create account. Once you're signed in, your session stays active for about a week before you'll need to sign in again.
Forgot your password? Requesting a reset#
If you can't remember your password, you can request a reset link by email.
- On the sign-in page, click Forgot password?
- Enter your Email and click Send reset link.
- Check your inbox for the reset email and click its link.
Note: For your privacy, CoPub shows the same confirmation message whether or not the email is registered — this prevents anyone from using the form to discover which addresses have accounts. So if you don't receive an email, double-check the address and that you signed up with a password (rather than Google/Microsoft).
Setting a new password#
When you open the reset link from your email, you'll land on the Reset your password page.
- Type your New password — the same rules apply (12+ characters, with a lowercase letter, an uppercase letter, and a digit).
- Click Reset password.
Note: Setting a new password signs you out of every other device as a safety measure — you'll simply sign in again with your new password. If the reset link has expired or looks tampered with, the page tells you clearly so you can request a fresh one.
Signing in with Google or Microsoft#
Signing in or signing up with a Google or Microsoft account is not offered. The sign-in page reads "Use your email and password." and the sign-up page "Sign up with your email and password.", with no provider buttons; a provider address typed by hand (such as /auth/google) answers "Unknown sign-in provider" and returns you to the sign-in page. Account security offers no switch to Google or Microsoft either.
Note — accounts are never merged by email: each Google or Microsoft account is its own separate sign-in, and an address first registered with a password cannot be taken over by a matching Google/Microsoft login. That stays true if Google / Microsoft sign-in is offered again.
Your dashboard#
After you sign in, your home base is the Research Projects dashboard. Its subtitle reminds you it shows "All projects you're a member of, across all your organizations." Here's what you'll find.
The stat row. Six tiles across the top give you an at-a-glance count of your projects by state:
| Tile | What it counts |
|---|---|
| Total Projects | Everything you belong to |
| In Progress | Active projects still being worked on |
| Under Review | Projects submitted for review |
| Completed | Finished projects |
| Published | Projects that have been published |
| Archived | Projects you've set aside |
Search and filters. A Search projects... box lets you find a project by name as you type. Next to it, a row of filter pills — All, In Progress, Under Review, Completed, Published, Archived — narrows the list to one status. The search and the active filter work together.
Project cards. Each project shows as a card with its title, a short description (if you added one), a colored status badge, who created it, and when it was last updated. Three quick-jump buttons at the bottom of every card take you straight into the project's key areas: Editor, Notes, and Refs (references). Click anywhere else on the card to open the project's overview.
Top-right buttons. A New project button (top right) starts a new project. If you administer an organization, you'll also see an Administer organization button that opens your organization's admin area — it only appears if you actually manage one.
Empty state. If you have no projects yet, the dashboard invites you to Create your first project to get started. If a search or filter simply hides everything, it tells you no projects match and suggests clearing the filter.
Creating a project#
- Click New project (from the dashboard's top-right button, or the empty-state prompt).
- Fill in the form:
- Title (required) — the project's name, up to 500 characters. Example placeholder: "Machine Learning in Healthcare Diagnostics."
- Description (optional) — a sentence or two on what the project is about.
- Keywords (optional) — comma-separated terms (e.g. deep learning, healthcare, diagnostics). These are used for journal-submission metadata and for discovery.
- Target journal (optional) — where you're aiming to publish, up to 255 characters (e.g. The Lancet, NEJM, BMJ). You can change this later.
- Click Create project (or Cancel / Back to Dashboard to bail out).
When the project is created you're taken straight into it, and you're automatically assigned as the Principal Investigator (PI) — listed as the first author and marked as the corresponding author. You can adjust authorship and add teammates afterward.
Tip: If this is your very first project, CoPub sets up your workspace/organization for you automatically — there's nothing extra to configure.
Note: The create page reminds you: "Add team members from the project Overview after creating." Team management lives inside the project once it exists (see below).
Project roles — who can do what#
Every person on a project has one role. The role decides what they're allowed to do. There are five roles, and each project always has exactly one PI.
| Role | Best suited for | What they can do |
|---|---|---|
| Principal Investigator (PI) | The project lead | Everything: read, write and edit documents, edit project settings, approve exports/submissions, change the project's status, invite and manage members, revoke invitations, chat with the team, and transfer the PI role to someone else |
| Co-Investigator | A senior collaborator | Read, write and edit documents, edit the Methods section, invite and manage members, revoke invitations, and chat |
| Research Fellow | A hands-on contributor | Read, write and edit documents, edit the Methods section, and chat |
| Statistician | Stats/analysis specialist | Read, edit the Methods section specifically, and chat |
| Research Coordinator | Operational coordination | Read the project and chat with the team |
A couple of things worth knowing:
- Everyone on a project can read it and take part in the chat — there's no read-only-chat role; if you can see the project, you can talk in it.
- Citation tools need full edit access, and this catches people out. Cite, Find papers and looking a paper up by DOI/ISBN/PMID are available to the PI, Co-Investigator and Research Fellow only. A Statistician can edit the Methods section but does not have full editing rights, and a Research Coordinator has none — so for those two roles the buttons are not shown, and the tools cannot be used even from a shared link. If you are a Statistician who needs to add a reference, ask a colleague with edit rights, or ask the PI to change your role.
- Only the PI can change the project's status, edit project-wide settings, approve exports, and transfer the PI role.
- The PI and Co-Investigators are the ones who can invite people, change roles, and remove members.
Note: If your organization has assigned you an organization-wide role (for example, a research director or an org administrator), that can grant additional access across the organization's projects on top of your per-project role.
Inviting and managing members#
Team management lives inside each project, under Settings → Members. You'll see the full member table and the invite tools here only if you're the PI or a Co-Investigator; other members can view the roster but not change it.
To invite someone:
- Open the project's Settings → Members page.
- In the Invite a member box, enter their email address.
- Pick a role from the dropdown — Co-Investigator, Research Fellow, Statistician, or Research Coordinator. (You can't invite someone directly as PI — that only happens through Transfer PI, below.)
- Click Invite.
What happens next depends on the person:
- If they already have a CoPub account in your organization, they're added to the project immediately and appear in the members table right away (you'll see "Member added.").
- If they don't have an account yet, or they're outside your organization (a member of another organization, or someone with their own workspace), an email invitation goes out and they show up in Pending invitations (you'll see "Invitation sent."). You get this same answer for every address outside your organization, so the page never reveals who has an account.
Note: The invitation email has an Accept the invitation button. It opens a CoPub page with an Accept button, for someone signed in with that same email address — opening the link grants nothing on its own, which is intentional, for safety. Someone new to CoPub signs in (or creates an account) using that address, and once their email is verified they're added to the project automatically; someone from another organization joins only by clicking Accept on that page (next note). Pending invitations expire after 14 days.
This note previously said the invitation email has "no link to click and no token". That was wrong: the email carries the Accept the invitation button described above.
Pending invitations appear in their own panel showing the email, the role, and the expiry date. PIs and Co-Investigators can Revoke any pending invite that hasn't been accepted yet.
Note: Someone from outside your organization joins only this project, and only when they open the invitation email's link while signed in with that address and click Accept on the page it opens. They are marked External in the members table and the Share panel. They can open and work on this project, chat with its members and use its AI, as a research fellow, statistician or coordinator — never a co-investigator or the PI, so someone you invite as a co-investigator joins as a research fellow. They see the names of the people on the project, not their email addresses, and nothing else of your organization. Their own projects stay in their own organization.
Changing a role. In the members table, PIs and Co-Investigators can change any non-PI member's role using the inline role dropdown. The PI row shows a star and can't be edited here — a PI's role only changes through Transfer PI.
Removing someone / leaving. Use the Remove button in a member's row to take them off the project (you'll be asked to confirm). Your own row shows Leave instead, so you can remove yourself. The PI can't simply be removed — you'll be prompted to transfer the PI role first.
Transferring the PI role. Because every project must have exactly one PI, handing off the lead role has its own two-step, safety-checked flow (visible only to the current PI):
- In the Transfer principal investigator role box, choose the member to promote.
- Type the project's title exactly to confirm.
- Click Transfer PI role.
The swap is instant and all-or-nothing: the chosen member becomes PI and you become a Co-Investigator in the same step, so the project never ends up with zero or two PIs. If there's no one eligible yet, CoPub tells you to invite a Co-Investigator first.
Your setup checklist (Complete setup 0/5)#
When you open a project's document editor, CoPub shows a small "Complete setup" meter — a friendly 0-to-5 checklist that helps you get the most out of a new project. It tracks itself automatically from what you actually do, and it quietly disappears once you've done all five.
The five steps are:
- Write 50+ words in a document
- Add a reference
- Organize a collection
- Try an AI feature (if AI is enabled for your workspace)
- Invite a collaborator
Click the meter to expand or collapse the checklist at any time.
Tip: You don't have to do these in order, and there's nothing to tick off manually — the moment you complete a step (say, adding your first reference), that item checks itself. When all five are done, the checklist hides itself so it stays out of your way.
The Manuscript Editor#
The Manuscript Editor is where you write your paper. It behaves like a familiar word processor — a formatting toolbar across the top and a clean writing page below — but it's built for research: headings that auto-number, figures and tables that number themselves, equations, footnotes, cross-references, citations, live journal formatting, version history, and one-click export to Word or PDF. You reach it by opening a project and choosing the Editor tab. Everyone on a project can read documents; creating, renaming, editing, archiving and restoring are available to team members with edit access. Everything works in both English and Arabic, including full right-to-left writing.
Note: Every document opens in the same editor. With real-time co-editing on (the default) several people can type together with visible cursors; with co-editing off for your workspace it is the same editor, with the same toolbar and features, saving through the page a few seconds after you stop typing. The few differences are called out where they matter.
The document sidebar: tabs, outline, and switching documents#
The left sidebar lists every document in the project. Each project can hold many documents (a manuscript, its abstract, a cover letter, a protocol, and so on).
- Click any document in the list to open it. The one you're viewing is highlighted, and the address updates so you can bookmark or share a direct link to that exact document.
- Under the open document, an outline appears automatically — every heading you've written, indented by level. Click any outline entry to jump straight to that section.
- Use the burger / chevron button at the top of the sidebar to collapse it to a slim icon strip when you want more room to write (it also starts collapsed on small screens). Collapse again to bring the titles and outline back.
Tip: If the outline says "Headings you add to the document will appear here," you simply haven't added any headings yet. Turn a line into a heading (see Structure blocks below) and it shows up instantly.
At the top of the list, an Active / Archived toggle switches between your working documents and ones you've set aside.
Creating a document#
-
Click + New document at the top of the sidebar (or the New document button on the empty-project screen). This opens the New-document window.
-
At the top is a short "What are you writing?" prompt box. As you type a sentence or two describing your paper, a live checklist shows which of four details your prompt names — who is studied, where, when and what is measured — and a bar fills as it names more (weak, good, strong). Every detail is optional; one you leave out is offered as a hint with examples. The more you describe, the better any assisted suggestions will be. The checklist reads English; a prompt written mostly in a non-Latin script, such as Arabic, shows a simple length guide instead.
-
Choose how the new document should start:
Starting style What you get Smart An outline tailored to the topic you typed (available when AI features are enabled for your workspace) Standard (IMRAD) A ready-made skeleton with Abstract, Introduction, Methods, Results, Discussion and Conclusion headings None A completely blank page -
Click Start Writing to create the document with your chosen starting style, or Create blank for an empty page with no prompt.
The window also offers two libraries of starting points:
- Research templates (left column) — pre-built document structures grouped by purpose, such as Manuscript, Abstract, Protocol, Grant, Review, Case report, Lab, and Letter. Click one to create a document already laid out for that kind of writing.
- Journal templates (right column) — publisher formatting presets, covered under Journal templates & citation style below.
Tip: The Smart and outline-seeding options draw on CoPub's writing assistant. See the AI Writing Assistant section for what it can do and how credits work.
Renaming, duplicating, archiving, restoring and deleting#
The document's title sits at the top of the editing area. To the right of it (and in each sidebar row) you'll find these controls:
- Rename — click the title or the rename control, type a new title, and confirm. Titles can't be blank.
- Duplicate — makes a full copy of the current document and opens it, so you can branch a draft without losing the original.
- Archive — hides a document you're no longer working on. You'll be asked to confirm. Archiving never deletes your work; the document simply moves to the Archived tab.
- Restore — open the Archived tab in the sidebar and click Restore on any row to bring the document back to your active list.
- Delete permanently — from the Archived tab only, you can permanently remove a document. This is irreversible, so a document must be archived first before it can be deleted.
Note: If you try to delete a document that hasn't been archived, CoPub asks you to archive it first — a deliberate safety step so nothing is lost by accident.
The writing surface and formatting toolbar#
The page in the centre is your live document — type directly onto it. The toolbar above gives you the everyday tools:
- Undo / Redo, ¶ Paragraph, and Heading 1 to Heading 4.
- Bold, Italic, Underline, Strikethrough, Superscript, Subscript, Highlight and Inline code.
- Bulleted list, Numbered list, Quote and Code block (a Divider is in the
/menu). - Footnote, Cite, Equation, Figure, Table (you choose rows × columns) and Cross-reference.
- The Format controls: font, size, text colour, alignment (left, centre, right, justify), line spacing, indent less / more, link, inline math and clear formatting.
- The view tools: Find and replace, Print (the title, the text with its footnotes, and the References), Check spelling, Zoom (50%–200%) and, with the cursor in a code block, Code language.
When the toolbar does not fit the window, its last groups fold under More tools. On a phone the toolbar wraps onto several lines and scrolls with the document, and the Format controls sit behind a Format button.
Every toolbar button works from the keyboard: press Tab to reach it, then Enter or Space. The buttons of a citation's own small editor (Apply, Read source, Remove) do too.
As you move the cursor, the toolbar highlights whatever's active at that spot (for example, it shows "Heading 2" and lights up Bold when your cursor is in bold text), so you always know the current formatting.
Tip: You can format without touching the mouse. Common shortcuts include Ctrl/Cmd + B / I / U for bold, italic and underline, Ctrl/Cmd + K to insert a link, Ctrl/Cmd + Shift + C to cite, Ctrl/Cmd + Shift + 7 / 8 for numbered and bulleted lists, and Ctrl/Cmd + Alt + 0/1/2/3 to switch between body text and headings, and, in a list, Ctrl/Cmd + ] to nest an item and Ctrl/Cmd + [ to lift it (the Format controls' + and − do the same). The full list is in the keyboard-shortcuts panel — open it from the shortcuts button near the top of the editor.
You can also format as you type, Markdown-style: start a line with # , ## or ### for headings, - or * for a bullet, 1. for a numbered list, > for a quote, or ``` for a code block. (Typing straight quotes, -- and ... also turns them into smart quotes, an em-dash and an ellipsis automatically.)
The slash "/" menu#
Type / at the start of a line to pop up a quick insert menu — no need to reach for the toolbar.
- Type
/on an empty line (or at the start of a line). - Keep typing to filter — for example
/quoteor/table. - Use ↑ / ↓ to move, Enter to insert, and Esc to close.
The slash menu offers:
| Item | Inserts |
|---|---|
| Heading 1 / 2 / 3 | A big, medium or small section heading |
| Bulleted list | An unordered list |
| Numbered list | An ordered list |
| Quote | A block quote |
| Code block | A monospaced code block |
| Table | A ready 3×3 table |
| Divider | A horizontal rule |
| Cite, Footnote, Equation, Figure | For people who can edit: the same as the toolbar's buttons |
Structure blocks: headings, lists, quotes, code#
- Headings organise your paper and feed the outline, the table of contents, and section numbering in Preview. Use Heading 1/2/3 from the toolbar, the slash menu, or Markdown (
#,##,###). - Lists — bulleted and numbered, with nesting: press Tab to indent an item and Shift + Tab to outdent.
- Quotes — a block quote for indented, set-off text.
- Code blocks — for computer code or commands. When you insert one you can pick a language, and CoPub highlights the syntax. Supported languages include Plain text, JavaScript, Python, Elixir, SQL, Bash and JSON.
Tables#
- Click Table on the toolbar (under More tools when the toolbar is folded).
- Choose the number of rows (1–20) and columns (1–10). A number outside that range is brought back into it, and the menu says so instead of inserting.
- Click Insert table. The first row is a header row. (Typing
/tabledrops in a ready 3×3 table.)
Tables are numbered automatically as Table 1, Table 2, … in Preview and in your Word/PDF exports — a new table from the moment it is inserted — and you can point to them with a cross-reference (see below). Add or change a table's caption with Edit caption… in its menu; press Tab to move from cell to cell.
Figures (image + caption)#
Figures let you place an image by its web address and give it a caption.
- Click Figure on the toolbar (or type
/figure). - Fill in:
- Image URL — a link starting with
http://orhttps://. - Alt text — a short description read aloud by screen readers.
- Caption — e.g. "Survival curves by treatment arm."
- Image URL — a link starting with
- Click Insert figure.
Figures are numbered automatically as Figure 1, Figure 2, … in Preview and exports. To change a placed figure later, click it to reopen the same panel.
Note: CoPub stores figures by their web link. When you export to Word or PDF, images hosted on trusted sources are embedded; an image from an unrecognised host falls back to its caption only. Always write a meaningful caption and alt text so the figure still makes sense either way.
Equations (LaTeX)#
You can write mathematics in LaTeX and CoPub renders it beautifully.
- Click Equation on the toolbar for a centred, standalone formula, or Inline math (in the Format controls) for a formula that sits within a sentence.
- Type the LaTeX — for example
E = mc^2. - Click Insert. The formula renders live on the page.
Display equations are numbered automatically as Equation 1, Equation 2, … and can be cross-referenced. Click a placed equation to edit its LaTeX.
Footnotes#
- Click Footnote on the toolbar (or type
/footnote). - Type the footnote text.
- Click Insert footnote. A small marker appears in your text, and the note itself is collected at the bottom in Preview and in your Word/PDF exports.
Footnotes are numbered automatically (1, 2, …) and can be cross-referenced. Click a footnote marker to edit its text: the field keeps the note's formatting (Ctrl/Cmd + B, I, U and K work inside it, as in a table or figure caption); Enter saves and Escape cancels.
Cross-references#
Cross-references let you write "see Figure 2" or "as shown in Table 1" and have the number stay correct even if you reorder things later.
- Click Cross-reference on the toolbar (under More tools when the toolbar is folded).
- Pick what you're pointing to — the picker is grouped into Figures, Sections, Tables, Equations and Footnotes, listing each item with a short preview.
- Choose one to drop a reference marker into your text.
When you switch to Preview (or export), each marker resolves to the real, current number — so renumbering figures never breaks your prose.
Autosave and the "edited elsewhere" notice#
You never have to press Save. With co-editing off, CoPub saves a few seconds after you stop typing, and Ctrl/Cmd + S saves at once; with co-editing on, your changes reach your collaborators as you type and a copy is written to the server a few seconds after an editing burst settles.
If another team member saves the same document while you have it open, a gentle banner appears telling you it was edited elsewhere; click Refresh to load their latest version. And if you try to save on top of a newer change, CoPub won't silently overwrite it — it asks you to refresh to the latest and reapply your edit, so nobody's work is lost.
Real-time co-editing and presence (if enabled for your workspace)#
When live co-editing is turned on, several people can write in the same document at once:
- A "who's here" bar shows coloured initials for everyone currently in the document; your own chip is marked (you).
- You see each collaborator's cursor live, labelled with their name in their own colour, so you can watch edits land as they type.
- People with view-only access can open the document and see who's present, but can't change the text.
- Your changes merge together smoothly in real time — there's no "save" button and no overwriting each other.
Version history and restore#
Every save is captured, so you can always look back or roll back.
- Click History in the editor's top bar (anyone who can read the document can open it).
- A timeline opens on the right, newest first — each entry shows who edited it and when.
- Click any entry to preview that version.
- To see what changed, use the Compare with dropdown: compare the selected version against the current document or against another version. Differences are highlighted so you can read the changes at a glance.
- To roll back, click Restore this version (available to team members with edit access; it's hidden on the newest version, since restoring the current one would do nothing). Restoring makes that version the live document — and is itself recorded as a new history entry, so nothing is ever truly lost.
Preview: bibliography and in-text citations#
The Preview button (top of the editor) flips the page from editing to a clean, finished view — exactly how the paper reads once everything is resolved. Preview:
- Numbers your headings and builds a table of contents (once you have a couple of headings).
- Numbers your figures, tables and equations and resolves every cross-reference to its real number.
- Turns your citation markers into properly formatted in-text citations.
- Appends a References (bibliography) list in your chosen style, and a Footnotes section.
- Applies your journal's typography and page margins, so you see the real look of the page.
Click Edit to return to writing. Preview is read-only — it never changes your draft.
Tip: Preview is the fastest way to sanity-check numbering and references before you export or submit. Use it whenever you've added or reordered figures, tables or citations.
Page setup and printing#
Open Page setup in the editor's top bar to control the physical page:
| Setting | Options |
|---|---|
| Page size | Letter, A4, Legal, A3, A5, B5 |
| Orientation | Portrait or Landscape |
| Margins | Normal (25 mm), Narrow (12.5 mm), Wide (50 mm), or Custom (enter Top / Right / Bottom / Left in millimetres) |
Click Apply to save. Your choices are reflected on the page and are respected when you print with Ctrl/Cmd + P or export to PDF.
Journal templates and citation style#
Journal templates apply a publisher's house style across your whole project in one click.
- In the New document window, look at the Journal templates column. You'll see presets for major publishers (for example Nature, Cell, The Lancet, JAMA, NEJM, BMJ, PLOS One, Scientific Reports, JCI, IEEE, Science, and a Generic IMRAD template). Each card shows its citation style and any editorial limits it enforces — such as a maximum abstract length or body-word count.
- Click a journal to make it your project's active template. CoPub cascades that publisher's formatting — font, margins and citation style — to your documents and opens a fresh page ready to write under those rules.
- To use a house style that isn't in the list, click + Custom and fill in the name, family, citation format and any word limits to create your own template. Custom templates you no longer need can be removed.
You can also set the citation style directly. Click the style pill (e.g. APA) at the bottom of the editor to open the style picker, which shows a live preview of a sample reference with tabs for Bibliography and In-text so you can see exactly how each style looks before choosing:
| Style |
|---|
| Default — follow the journal template |
| AMA (11th ed.) |
| APA (7th ed.) |
| Chicago (17th, author–date) |
| Harvard |
| IEEE |
| MLA (9th ed.) |
| Nature |
| Vancouver |
Your selection overrides the journal template's default for that project, and every in-text citation and the bibliography update to match.
Tip: Set the journal template first — it fills in a sensible citation style, page size and margins for you. Then only change the citation style separately if you need something different from the journal's default.
Exporting to Word, PDF and LaTeX#
When your draft is ready to share or submit, use the export links in the editor's top bar. Each one downloads a finished file with your numbering, cross-references, citations and bibliography fully resolved:
| Export | File | Best for |
|---|---|---|
| Word | .docx |
Co-authors and journals that require Word |
.pdf |
A polished, fixed-layout copy for reviewing or printing | |
| LaTeX | .tex + .bib (in a ZIP) |
Journals and authors who typeset in LaTeX |
Just click the format you want and the file downloads — the editor keeps running while it does. Any reader can export.
Note: Exports honour your page setup and journal template, so the Word and PDF you download match what you see in Preview.
Word count, citation check, and more#
At the bottom of the editor you'll always see a live word count. Next to it, a citation check flags two easy-to-miss problems: sources you've cited that aren't in your project's reference library, and references in your library that no document actually cites — click the badge to see the details and tidy them up.
The editor's top bar also holds tools that have their own tutorials: Comments for inline review and discussion, Share for read-only links to people outside the project, the writing assistant and citation tools. For those:
Tip: See the AI Writing Assistant section for drafting help, outlines, review and the document chat, and the Citations & References section for adding, inserting and formatting sources.
Citations & Reference Styles#
CoPub lets you cite the papers in your project's reference library right inside the document you're writing, then turns those in-text markers into a properly formatted reference list automatically. You never format a citation by hand: you point at a reference, CoPub inserts a small citation "chip," and when you open Preview or export to PDF or Word it renders every marker and builds the bibliography in the style you've chosen. This works the same whether your workspace is in English or in Arabic (right-to-left).
Note: You can only cite references that are already in your project's library. If a reference isn't there yet, add it first (in the Reference Manager for the project). Everywhere a citation picker is empty, you'll see "No references in this project yet" with a shortcut to Open the Reference Manager.
Insert a citation as you write — the "@" menu#
The fastest way to cite is to type @ while writing, exactly like mentioning a person.
- In the document body, type @ at the start of a line or after a space.
- A small picker opens right at your cursor, listing your project's references (each row shows the paper's title and a short author · year · journal subtitle).
- Keep typing to filter — the letters after @ search across title, authors, and year. The first match is highlighted automatically.
- Press Enter to insert the highlighted reference, or use ↑ / ↓ to move the highlight first. You can also click a row with the mouse.
- CoPub replaces your
@…text with a citation chip (a short label such as[Johnson 2024]) and adds a space after it so you can keep typing.
Tip: The menu only stays open while you're clearly citing. If you type a space after @, CoPub assumes you're writing normal prose and closes it. Press Esc any time to dismiss it without inserting.
Insert a citation from the toolbar — the Cite button#
If you'd rather browse the full list, use the toolbar.
- Click Cite on the editor toolbar (keyboard shortcut Ctrl + Shift + C). You can also type / for the slash menu and choose Cite a reference.
- The Cite popover opens with a Filter by title, author, or year… box, an optional Narrative checkbox and Page box (explained below), and the list of references.
- Type in the filter box to narrow the list; a "No references match" line appears if nothing fits.
- Click a reference to drop its citation chip at your cursor.
Tip: If you're co-writing a document live with teammates, the shared editor's toolbar also has its own Cite button that opens a reference picker — the citation it inserts behaves identically.
Narrative, parenthetical, and page-locator forms#
Author–year styles (APA, Harvard, MLA, Chicago) can show a citation three ways. This is what the Narrative checkbox and Page box control. Numeric styles (IEEE, Vancouver, AMA, Nature) always render as a small superscript number, so these options don't apply to them.
| Form | How to get it | Example (APA) |
|---|---|---|
| Parenthetical (default) | Leave Narrative unchecked | (Johnson, 2024) |
| Narrative | Tick Narrative — the author's name reads as part of your sentence | Johnson (2024) |
| With a page locator | Type a page/range in the Page box (e.g. 23 or 112–128) |
(Johnson, 2024, p. 23) |
- Set it while inserting: the Narrative and Page controls in the toolbar Cite popover apply to the next citation you insert from it.
- Change it later — per-citation editing: click any citation chip already in your document. A little Citation locator editor pops up with a Narrative checkbox and a Page box, pre-filled with that citation's current settings. Adjust them and click Apply (or press Enter; Esc cancels). The change saves automatically.
Note: Each style shows the page locator its own way — APA/Harvard use
, p. 23, Chicago uses, 23, MLA uses23. You just type the number; CoPub formats it to match the chosen style.
Reading and checking your citations#
- Hover preview: hold your pointer over any citation chip to see a tooltip with the paper's title, authors, journal, and year — a quick way to confirm you cited the right source.
- Tap to jump: in the live preview and in exported PDF and Word files, every in-text citation is a link to its entry in the reference list, so readers can jump straight to it.
- Grouped numbers (numeric styles): if you cite several references back-to-back, CoPub tidies the superscripts automatically — two become
⁵,⁶and a run of three or more collapses to a range like⁵–⁷. - Missing references: if you cite a reference and it's later removed from the library, its marker still shows in the text but is flagged with a discreet wavy underline and a tooltip saying the reference wasn't found — so you can see exactly which one to fix.
- Citation linter: near the word count, a "… citation issue(s)" badge appears when something needs attention. Opening it lists two problems: Cited but not in references (markers with no matching library entry — usually a reference that was archived after you cited it) and In references but never cited (library entries no document uses — remove them or cite them).
The reference list (bibliography)#
You don't build the bibliography — CoPub does. When you open Preview or export, a References section is added at the end of the document containing exactly the references you cited, formatted in the project's style. Entries appear in the order they were first cited in the document. Numeric styles produce a numbered list; author–year styles produce a paragraph list. Any DOI becomes a clickable link.
Choosing a reference style for the project#
One style setting governs the whole project — every in-text citation and the reference list re-format together, instantly, when you change it. You never redo your citations.
- In the editor header you'll see the current style as a small chip, e.g. APA ▾. Click it. (The Citation settings panel also shows the current style and points you to this chip.)
- The Citation style window opens with the list of styles on the left and a live Preview on the right.
- Toggle the preview between Bibliography and In-text to see how a sample reference will look in each style.
- Click a style to select it — a checkmark marks the active one, and the change is saved for the whole project immediately. Click Done to close.
The choices are:
| Option | Meaning |
|---|---|
| Default — journal template | Follow whatever format your project's journal template specifies |
| AMA (11th ed.) | Numeric, medical journals |
| APA (7th ed.) | Author–year, common in health & social sciences |
| Chicago (17th, author–date) | Author–year |
| Harvard | Author–year |
| IEEE | Numeric, engineering/technical |
| MLA (9th ed.) | Author–page |
| Nature | Numeric, life sciences |
| Vancouver | Numeric, biomedical |
Note: The Search more styles & locales box in this window is marked Coming soon — today CoPub offers the eight curated styles below. Editing the style is available to project members with edit access.
The eight built-in styles#
Every style renders the same reference two ways: an in-text marker where you cite, and a reference-list entry at the end. Numeric styles show a superscript number in text; author–year styles show the author and year.
| Style | Type | In-text marker |
|---|---|---|
| APA | Author–year | (Johnson, 2024) |
| Harvard | Author–year | (Johnson, 2024) |
| MLA | Author–page | (Johnson) — or (Johnson 128) with a page |
| Chicago | Author–year | (Johnson 2024) |
| IEEE | Numeric | ¹ (superscript, tap to jump) |
| Vancouver | Numeric | ¹ |
| AMA | Numeric | ¹ |
| Nature | Numeric | ¹ |
Here is how each style formats the same reference in the reference list (this is the exact sample shown in the style picker's live preview — Johnson, Chen & Patel, 2024):
- APA — Johnson, E. R., Chen, W., & Patel, A. (2024). The impact of artificial intelligence on modern research methodologies. Journal of Computational Science, 42(3), 112-128. https://doi.org/10.1234/jcs.2024.0042
- IEEE — E. R. Johnson and W. Chen and A. Patel, "The impact of artificial intelligence on modern research methodologies," Journal of Computational Science, vol. 42, no. 3, pp. 112-128, 2024.
- Vancouver — Johnson ER, Chen W, Patel A. The impact of artificial intelligence on modern research methodologies. Journal of Computational Science. 2024;42(3):112-128.
- Harvard — Johnson, E. R., Chen, W. and Patel, A., (2024). The impact of artificial intelligence on modern research methodologies. Journal of Computational Science, 42(3), 112-128.
- MLA — Johnson, E. R., et al. "The impact of artificial intelligence on modern research methodologies." Journal of Computational Science, vol. 42, no. 3, 2024, pp. 112-128.
- Chicago — Johnson, E. R., et al. 2024. "The impact of artificial intelligence on modern research methodologies." Journal of Computational Science 42(3): 112-128.
- AMA — Johnson ER, Chen W, Patel A. The impact of artificial intelligence on modern research methodologies. Journal of Computational Science. 2024;42(3):112-128.
- Nature — Johnson, E. R., Chen, W. & Patel, A. The impact of artificial intelligence on modern research methodologies. Journal of Computational Science 42, 112-128 (2024).
Tip: Long author lists are shortened automatically the way each style expects — for example APA switches to "et al." after seven authors, Vancouver and IEEE after six, Nature after five — so you don't have to trim them yourself.
Turning pasted "[1]" markers into linked citations#
If you paste text from another manuscript that already has a References section and inline markers like [1], CoPub can turn those into real, linked citations for you.
- On paste: when CoPub spots a References section in what you pasted, an Import references from this paste? window appears. It shows how many references it parsed, how many are Already in project, and how many Body markers linked. Choose Import + link (adds the references to your library and replaces the inline markers with live citation chips), Paste as plain text (skip importing), or Cancel. If some entries couldn't be read, or if the body has no recognizable markers to link, CoPub warns you and explains how to fix it.
- On demand: for a document you're already editing, open Match citations in this document in the Citation settings panel (available if this is enabled for your workspace). CoPub matches your text's markers and existing library references and links them up.
At a high level, matching finds the reference each marker refers to and replaces the plain marker with a proper citation chip, so from then on it renders and links like any citation you inserted yourself.
Note: The Citation settings panel also has filters that shape which references citation-matching and suggestions will surface — a Publish year range, a minimum Impact factor, a Sources choice (library, external, or both), an Open-access sources only toggle, and Show page numbers in citations. Your own library references are always eligible; these filters only narrow external suggestions.
AI citation suggestions (if enabled for your workspace)#
Some workspaces also have an assistant that recommends citations for a passage:
- Select the sentence or paragraph you want to support.
- Choose Suggest citations (the Cite action on the floating selection toolbar).
- A Suggested citations panel lists the best matches from your project library, each with a one-click Cite button. If nothing in your library fits, it tells you so and suggests adding references first.
References & Importing#
Every project in CoPub has its own Reference Manager — a shared library of the papers, books, datasets and other sources your team is working from. You can build it by typing references in by hand, by pulling them automatically from a DOI, by importing files your other tools export, by pasting the reference list straight out of a PDF, by saving papers from the web as you browse, or by connecting your Zotero account. This section walks through every way to get references in, and everything you can do with them once they're there.
To open it, go into a project and choose References in the workspace menu. The page is titled Reference Manager, and a small counter next to the title shows how many references are currently in view.
Note — who can do what. Adding, importing, editing, and archiving references is available to the project lead and to members with editor access. Anyone who can open the project can browse the library, follow a reference's link, and save a copy to their own personal library. If you don't see the buttons described below (Add Reference, Import, and so on), you have viewing access rather than editing access.
The reference types#
Every reference has a Type. You'll see these as filter buttons across the top and as a dropdown on the forms:
| Type | Use it for |
|---|---|
| Article | Journal articles (the default) |
| Book | Whole books |
| Chapter | A chapter or section within a book |
| Conference | Conference papers and proceedings |
| Preprint | Preprints and unpublished manuscripts |
| Dataset | Published datasets |
| Website | Web pages and online resources |
| Other | Anything that doesn't fit the above |
Finding references in your library#
- Use the Active and Archived tabs to switch between your current library and references you've retired.
- Type in the Search title or author… box to filter the list. It searches reference titles and author names, and updates as you type.
- Click a type filter button (All, Article, Book, and so on) to show only one kind of reference. Click it again, or click All, to clear the filter.
Tip: Search and the type filters work together — for example, filter to Article, then search an author's surname to find just their papers.
Reading a reference card#
Each reference appears as a card showing its type badge, its DOI (if it has one), the title, the authors, and a journal line (journal, volume, issue and year, whichever are filled in). If someone on your team added it, you'll also see Added by [name] and the date. On the right of each card are quick actions:
- Open URL (the arrow icon) — opens the source link in a new tab, if the reference has one.
- Save to My Library (the book icon) — copies this reference into your own personal library so you can reuse it across projects. This is available to everyone, and it's safe to click more than once — you won't create duplicates.
- Archive (the box icon) — retires the reference (editors only; see below).
Click a reference's title to open its full details.
The reference details drawer#
Clicking a title slides out a panel on the right showing everything recorded for that reference — Type, Title, Authors, Year, Journal, Volume, Issue, Pages, Citations (a scholarly citation count, when one is known), DOI, PMID, URL (as a clickable link), Abstract, and Added by. Empty fields are hidden to keep the panel clean.
- To close the drawer, click the ✕, or click anywhere outside the panel.
- If you have editing access, an Edit button appears at the bottom.
Adding a reference by hand#
- Click Add Reference. A New reference form opens.
- Fill in the fields. Title is the only required one; Type, Authors, Year, Journal, Volume, Pages, DOI and URL are all optional.
- In the Authors (comma-separated) box, separate authors with commas and write each one as first name then surname — for example
Jane Smith, Wei Liu. - Click Save reference.
A few gentle rules the form enforces:
- Year must be between 1500 and 2200.
- DOI must be a real DOI (they start with
10.). - If a reference with the same DOI is already in this project, CoPub won't add a duplicate — instead you'll see a friendly note that it's already in your library.
Tip: You can cancel at any time with the Cancel link in the form header.
Auto-filling from a DOI#
If you have a paper's DOI, you don't have to type its details.
- Click Add Reference to open the form.
- At the top, in the Have a DOI? Auto-fetch from Crossref box, paste the DOI. CoPub accepts it in any common form —
10.1056/NEJMfoo24,doi:10.1056/…, or a fullhttps://doi.org/…link. - Click Fetch. CoPub looks the paper up and fills in the title, authors, year, journal, and more for you.
- Review the details, adjust anything you like, and click Save reference.
If the lookup can't find a match you'll see a clear message — for example that there's no record for that DOI, that it doesn't look like a valid DOI, or that the lookup service couldn't be reached — and you can simply type the reference in instead.
Importing from a file (BibTeX, EndNote XML, RIS)#
If you already keep references in another tool, export them and bring them in as a batch.
- Click Import. The Import references panel opens.
- Choose the format with the buttons at the top:
| Format | File | Comes from |
|---|---|---|
| BibTeX (.bib) | .bib |
Nature, IEEE, Lancet, Mendeley, Zotero, and most reference tools |
| EndNote XML (.xml) | .xml |
EndNote, Mendeley, Zotero |
| RIS (.ris) | .ris |
Zotero, Mendeley, EndNote, PubMed, Scopus |
- Either paste the content into the text box, or upload a file — you can click to choose it or drag and drop it onto the dashed area. Files must be
.bib,.xml, or.ris, and up to 5 MB. - Click Validate & import.
If everything looks clean, your references are added straight away and you'll see how many were imported.
Note: If you both paste text and choose a file, the uploaded file takes priority.
The cleanup preview#
Reference files exported from other tools sometimes carry hidden formatting problems — garbled characters, odd spaces, or "smart" punctuation. When CoPub spots these, instead of importing them silently it shows a Review before importing screen listing exactly what it found:
| What CoPub flags |
|---|
| Encoding garbage (mojibake) |
| Non-breaking spaces |
| Smart quotes |
| Em-dashes and en-dashes |
| Ellipses |
| Byte-order marks |
Unescaped % characters in fields |
You then choose how to proceed:
- Clean & import (recommended) — CoPub repairs the formatting and imports the tidied-up references.
- Import as-is — imports the content exactly as it was, problems and all. Use this only if you've looked at the records and you're happy with them.
- Cancel / Back — return to the import screen without importing.
If a file is genuinely broken and can't be read at all, you'll get a plain error message (and the clean-up option won't be offered, since cleaning wouldn't help). You'll also see friendly messages if a file is too large, isn't one of the accepted types, or is empty.
Importing the reference list straight from a PDF#
Sometimes you don't have a tidy export file — you just have the text of a paper, references section and all. The Paste from PDF tool turns that raw text into real references.
- From the Reference Manager, click Paste from PDF. This opens the Import references from text page.
- Paste in the text — ideally the body of the paper plus its References (or Bibliography) section. CoPub understands the four common reference styles and detects which one you've pasted:
| Style | Looks like |
|---|---|
| Vancouver | Numbered 1., 2. … with compact author initials |
| APA | Surname, I. I. (Year). with periods after initials |
| IEEE | Numbered [1], [2] … with the title in quotes |
| Harvard | Like APA, but joins authors with "and" |
- Click Parse. CoPub shows a Preview with three counts: how many references were parsed, how many are already in the project, and how many in-text citation markers it could line up with those references. It also tells you which style it detected.
- Any lines it couldn't make sense of are listed under entries couldn't be parsed so you can see exactly what to fix or add by hand.
- When you're happy, click Confirm import. You'll get an Import complete summary showing new versus existing references and how many in-text citations were linked, plus links to View references or Import more.
Note: This tool needs to find a heading such as References, Bibliography, Works Cited, Literature Cited, or Citations in what you paste. If there's no such heading it will let you know it couldn't find a references section. It's a best-effort reader of messy PDF text, so expect to tidy up a few entries — the ones it can't parse are always shown to you rather than dropped quietly.
Tip: If you opened this tool from a document you're writing, confirming the import can also drop the matched citations into that document for you. A version snapshot is kept first, so it's fully undoable, and if that document happens to be open elsewhere CoPub handles it safely rather than overwriting your work.
Discovering and searching for papers#
CoPub can search the world's research databases and let you add results with a single click. This feature is available if external paper search is enabled for your workspace — if you don't see the Search PubMed and Discover papers buttons, it isn't turned on for you.
Searching PubMed (biomedical literature):
- Click Search PubMed.
- Type a query — plain words like
covid-19 anosmia 2024, or a specific DOI. - Click Search. Results show the PMID, DOI, title, authors, and journal.
- Click Add on any result to bring it into your library. Once added, the button changes to Added, and it won't create a duplicate if it's already there.
Discover papers (OpenAlex — a broad catalogue of 250M+ works across every field):
- Click Discover papers.
- Type your search and click Search.
- Each result shows how many times it's been cited, an Open access badge where it applies, a journal impact figure when available, and the DOI.
- Click Add to import it, the same way as PubMed.
Matching a whole citation list. When you use the Paste from PDF tool, the preview also offers Match citations. This checks each citation you pasted against — in order — your project's own library, then external databases, and marks each one as Matched, Pick a match, or No match. For anything ambiguous you get a dropdown to choose the right paper, keep it as you pasted it, or skip it. This citation matching also relies on external paper search being enabled for your workspace.
Saving papers from the web with the browser extension#
Not yet available. The Web Importer browser add-on is still in development and is not published to any browser store, so it cannot be installed. This section describes what it will do; it is kept here so the guide stays honest about what exists rather than quietly promising it.
In the meantime, the same job is done inside CoPub: on the References page, Add source → from a PDF reads the paper's details out of the file and adds it to your library, fetching an open-access PDF where one is available.
When the add-on does ship, it will let you save a paper into your project library with one click straight from the page you're reading — a journal site, a preprint server, anywhere — and let you point the save at a specific collection.
Where a paper has a DOI, saving it again won't create a duplicate: the DOI is what identifies it. A paper with no DOI has nothing stable to match on, so saving it twice would create two entries.
Connecting Zotero and importing your library#
If you use Zotero, you can connect it once and then pull your library into any project.
Connect Zotero (once):
- Go to Account → Connections.
- In the Zotero card, paste an API key generated from
zotero.org/settings/keysand submit it. CoPub checks it's valid and confirms with Zotero connected as [your username]. Your key is stored encrypted and is only ever sent back to Zotero.
Import your library into a project:
- In a project, open the Reference Manager and click Import.
- Under More import methods, click Import from Zotero. (If you haven't connected yet, you'll see Connect Zotero to import instead, which takes you to the Connections page.)
- CoPub pulls in your most recent Zotero items and reports the result — for example "Zotero import: 34 added, 8 already in the library."
Re-importing is always safe: anything already in the project (matched by DOI) is counted as already present rather than duplicated. Attachments and notes in Zotero are skipped — only real bibliographic items come across.
Note: Mendeley appears in the same More import methods area but is marked unavailable, because Mendeley has closed its service to new connections. To bring Mendeley references in, use its own BibTeX or RIS export with the file import above.
Editing a reference#
- Open a reference by clicking its title, then click Edit (editors only).
- Update any field: Type, Title (required), Authors, Year, Journal, Volume, Issue, Pages, DOI, URL, and Abstract.
- In the edit form, the Authors box uses a slightly different shorthand than the add form — separate authors with semicolons and write each as Family, Given, for example
Smith, J; Liu, W; Patel, R. The hint under the box reminds you. - Click Save, or Cancel to discard your changes.
If you change the DOI to one another reference in the project already uses, CoPub will stop you with a clear message.
Archiving and restoring#
Archiving keeps your working library focused without deleting anything.
- On any reference card (in the Active tab), click the Archive icon and confirm the prompt.
- To see archived references, switch to the Archived tab. Each shows when it was archived.
- To bring one back, click the Restore icon in the Archived tab.
Archived references free up their DOI, so you can add a fresh reference with the same DOI while the old one stays archived. If you try to restore a reference whose DOI is now used by an active one, CoPub will let you know rather than create a clash.
Exporting your references#
You can take your library out of CoPub at any time to use in other tools:
- Export .bib downloads your references as a BibTeX file.
- Export .ris downloads them as an RIS file.
Both are the standard formats that Zotero, Mendeley, EndNote and reference tools understand.
If your library is empty#
When there's nothing to show, the page tells you why — whether the project simply has no references yet (with a nudge to add or import one), or your current search or filter just isn't matching anything, or there are no archived references. Clearing your search and filters brings the full list back.
Research Library & My Library#
CoPub gives you two places to keep the papers you care about. The Research Library lives inside a project and is shared with everyone on that project — it is where your team curates the project's references into reading lists and attaches PDFs. My Library is your own personal shelf that follows you across every project you belong to. This section walks through both, button by button.
Note: The project Research Library was merged into the References page — there is no separate Library entry in the project menu any more, and the old address forwards there. My Library (under /library) is unchanged and is always available to every signed-in user. Neither is an optional module, and there is nothing to ask an administrator to switch on.
Part 1 — The project Research Library (now part of References)#
This surface no longer exists as a separate page. Everything the project
Research Library did — collections, curation filters, text and smart search, and
attaching PDFs per item — was merged into the References page and is
documented there under References & Importing. The old Library entry was
removed from the project menu, and the old address
(/projects/<project>/library) now simply forwards to References, so
existing links and bookmarks keep working.
Nothing was lost in the move; there is one page instead of two.
Why this section is still here. Earlier versions of this guide devoted roughly 130 lines to a Library page, ending with the advice to "ask your workspace administrator to turn it on" if you couldn't find it. There was nothing to turn on — the menu entry had been deliberately deleted when the two pages merged. Rather than delete this section silently, it is kept as a signpost for anyone following an old link, an old bookmark, or a printed copy.
Reading a PDF with AI has its own home and is unaffected: open any reference that has a PDF attached and choose Read. That is covered under Reading a PDF with AI later in this guide.
Part 2 — My Library (your personal, cross-project shelf)#
My Library is your own private collection of papers, reachable at /library from anywhere in CoPub. Unlike the project Research Library, it isn't tied to a single project — it's yours alone, and only you can ever see it. The page is headed My Library with the note "Your personal, cross-project reading library."
How papers get into My Library#
There's no "add" button on this page itself — that's by design. You fill My Library from other screens:
- From any project's References screen, save a paper you want to keep for yourself.
- From citation-match or discovery results, save a paper you found while searching external sources.
Saved papers then appear here for you to search, annotate, and manage. Until you've saved anything, the page shows a friendly empty state: "Your library is empty — Save a paper from any project's References screen, or from citation-match results, and it will appear here."
Tip: Saving the same paper twice is safe. My Library recognises a paper you've already saved and won't create a duplicate.
What each saved paper shows#
Each entry is a card showing its title, then a line of details — authors, year, journal, and DOI where available — followed by any tags and notes you've added. A small coloured badge on the right tells you where the paper came from:
| Badge | Meaning |
|---|---|
| from a project | You saved it from a project's References screen |
| a source name (e.g. crossref, openalex, pubmed) | You saved it from an external discovery search of that source |
| manual | It was added by hand |
Searching My Library#
At the top is a single filter box: "Filter by title, author, journal, or tag…". Type into it and the list narrows instantly to entries whose title, author names, journal, or tags contain what you typed. Clear the box to see everything again. If nothing matches, CoPub tells you "Nothing matches your filter."
Adding notes and tags#
Every entry can carry your own private notes and tags — these are your overlay on the paper and don't change the paper's saved details.
- Click the pencil icon on the entry (its tooltip reads "Notes & tags").
- In the panel that opens, type free-form notes in the large box.
- In the tags field, type tags separated by commas — for example
to-read, methods, key-paper. You can add up to 20 tags per entry; blanks and extra spaces are tidied up automatically. - Click Save (CoPub confirms with "Saved."), or Cancel to discard your edits.
Your notes appear on the card afterward, and your tags show as small coloured chips. Because tags are searchable, they're a quick way to group papers across every project — filter by a tag to pull up everything you marked the same way.
Uploading your own PDF#
You can attach your own copy of a paper to any entry:
- On an entry with no PDF, click Upload PDF.
- Choose a PDF file, up to 50 MB.
- Click Save (or Cancel to stop). CoPub confirms with "PDF attached."
Once attached, the entry shows a PDF link instead — click it to open your copy in a new tab. This PDF is yours and stays with your personal entry.
Removing a paper#
To take a paper off your shelf, click the archive icon (its tooltip reads "Remove"). CoPub asks "Remove this paper from your library?" and, once you confirm, removes it and shows "Removed from your library." This only affects your personal library — it never touches the project's references or anyone else's library.
Note: My Library is strictly private. Every paper, note, tag, and PDF here belongs to your account only; no teammate and no project ever sees your personal shelf.
Tasks & Files#
Every project in CoPub has its own Tasks board for tracking who is doing what, and its own Files area for keeping the documents, datasets, and references your team works from. Both live inside the project you open, and both are shared with everyone on that project. This section walks you through each of them, button by button.
Note: CoPub is fully bilingual (English and Arabic). If your workspace is set to Arabic, every screen described here mirrors right-to-left — the layout flips, but all the same buttons, fields, and steps are in the same order.
Tip: What you can do on these screens depends on your role in the project. Everyone on a project can look at the Tasks board and the Files list; creating, moving, assigning, uploading, and removing are reserved for certain roles. Each subsection below tells you exactly who can do what.
Finding the Tasks board#
Open your project, then choose Tasks from the project menu. The board opens on the Tasks heading with two things at the top right: a view switcher (List / Kanban) and, when your project has more than one member, an assignee filter.
There are two ways to look at the very same tasks:
| View | What it looks like | Best for |
|---|---|---|
| List (default) | Tasks stacked in vertical groups, one group per status, each group labelled with a count | Reading through everything and ticking tasks off |
| Kanban | Five side-by-side columns you can drag cards between; scrolls sideways on a phone | Seeing the flow of work and re-ordering by hand |
To switch, click List or Kanban in the toggle at the top right. Your choice is saved into the page address, so you can bookmark or share a link that opens straight into the view you prefer.
Understanding statuses and priorities#
Every task has a status (where it is in the workflow) and a priority (how urgent it is).
There are five statuses. A task can move freely between any of them — there is no fixed order, so you can send a task back to To Do from Done if the work needs revisiting.
| Status | What it means | Colour cue |
|---|---|---|
| To Do | Not started yet | Grey |
| In Progress | Being worked on now | Orange |
| In Review | Waiting for a check or approval | Blue |
| Done | Finished | Green |
| Blocked | Stuck, waiting on something | Red |
There are three priorities, shown as a small coloured dot on the left of each task:
| Priority | Dot colour |
|---|---|
| High | Red |
| Medium (default) | Amber |
| Low | Grey |
Creating a task#
The new-task bar sits just under the heading. It appears only if you have editing rights on the project (Principal Investigator, Co-Investigator, or Fellow). If you don't see it, your role is view-only for tasks.
- In the field reading "Add a task — what needs to happen?", type a short title. This is the only required field. Titles can be up to 500 characters.
- Pick a priority from the dropdown — Medium (pre-selected), High, or Low.
- Optionally choose a due date with the date picker.
- If you are a project lead (Principal Investigator or Co-Investigator) and the project has members, an assignee dropdown appears. Choose Unassigned or a teammate's name. (Fellows see the task bar but not this dropdown — see Assigning tasks below.)
- Click Add Task.
The task appears immediately in the correct status group (new tasks start as To Do) and a "Task created." confirmation flashes at the top. New tasks always land at the bottom of their column.
Note: If you try to add a task without a title, you'll see "Task title is required." and nothing is created.
Assigning tasks to members#
Assigning a task tells everyone who is responsible for it. In this version, a task is assigned at the moment it is created, using the assignee dropdown in the new-task bar (see step 4 above). Only project leads — Principal Investigator and Co-Investigator — can set an assignee.
Once assigned, the teammate's name (or email) shows on the task in both views. The assignee also quietly gains the ability to move their own task along — see the next subsection.
Tip: Assigning a task to someone (other than yourself) lets them know it's now theirs — they'll see it in their notifications and in the project's upcoming-tasks list. Assigning a task to yourself doesn't trigger a notification.
Updating a task (List view)#
In List view, each task is a row with several controls, from left to right:
- The round checkbox — click it to mark the task Done. The circle fills green with a tick and the title gets a line through it. Click it again to send the task back to To Do.
- The priority dot — a colour reminder of how urgent the task is (see the priority table above).
- The title, with the due date underneath if one was set, and the assignee's name on the right if the task is assigned to someone.
- The status dropdown — pick any of the five statuses to move the task there directly (this is the quickest way to reach In Progress, In Review, or Blocked without dragging).
- The archive button (a small box icon) — only visible to project leads; see Archiving a task below.
Who can change a task's status or tick it off:
- Members with editing rights (Principal Investigator, Co-Investigator, Fellow) can update any task.
- Anyone the task is assigned to can move their own task forward — even a Statistician or Coordinator who otherwise has view-only access can push a task they own to Done.
If you don't have permission for a particular task, you'll see a short "You can't change this task." message and nothing changes.
Note: In this version, a task's title, priority, due date, and assignee are fixed once it's created — the interface lets you change its status and its order, which covers day-to-day tracking. If a task's core details are wrong, the simplest fix is to archive it and create a fresh one with the right information.
Reordering and moving tasks (Kanban view)#
Switch to Kanban view to see the five status columns side by side, each with a count of how many tasks it holds (empty columns still show, so you always see the full workflow). On a narrow screen the board scrolls sideways.
- Drag a card into another column to change its status — for example, drag a card from In Progress into Done.
- Drag a card up or down within a column to change its order relative to the others.
Your new arrangement is saved automatically. The same permission rule applies as in List view: editors can move any card, and an assignee can always move their own.
Tip: Kanban cards are compact on purpose — each shows the priority dot, the title, and (if set) the assignee and due date. Use List view when you want the tick-off checkboxes and the status dropdown.
Filtering by assignee#
When a project has more than one member, an All assignees dropdown appears at the top right. Pick a teammate to show only the tasks assigned to them; choose All assignees to clear the filter. The filter works in both List and Kanban views, and (like the view switch) it's reflected in the page address so you can share a filtered link.
Archiving a task#
Archiving tidies a task away without deleting your history. Only project leads (Principal Investigator, Co-Investigator) can archive.
- In List view, click the small archive (box) icon at the far right of the task row.
- Confirm when asked "Archive this task?".
The task disappears from the board and a "Task archived." message appears. Archived tasks no longer show in any status group or column.
Note: If you don't have permission, archiving is blocked with "Only project leads can archive tasks."
Finding the Files area#
From your project menu, choose Files. The Files screen shows, at the top: the heading, a count of how many files the project holds (a folder icon with a number), and a reminder chip reading "Max 100 MB per file."
Everyone on the project can open this screen and see and download its files. Uploading and removing are for members with editing rights.
What you can store#
CoPub accepts the file types researchers actually work with:
| File type | Extensions |
|---|---|
| PDF documents | .pdf |
| Microsoft Word | .doc, .docx |
| Microsoft Excel | .xls, .xlsx |
| Microsoft PowerPoint | .ppt, .pptx |
| Comma-separated data | .csv |
| Plain text | .txt |
| BibTeX references | .bib |
| ZIP archives | .zip |
| Images | .png, .jpg / .jpeg, .webp, .gif |
Two limits apply:
- Per file: up to 100 MB. A larger file is refused with "File is too large (max 100 MB)."
- Per workspace: your organisation shares a total storage allowance. The standard free allowance is 1 GB, and higher limits come with paid plans. Everything your workspace stores — project files as well as attachments elsewhere in CoPub — counts toward this shared pool.
Tip: If an upload won't go through even though the file is under 100 MB, your workspace's storage may be full. Remove files you no longer need, or ask whoever manages your workspace about a larger allowance.
Uploading files#
The upload zone — a dashed box reading "Drag files here or browse" — appears only if you have editing rights (Principal Investigator, Co-Investigator, or Fellow). Under it, a line reminds you of the accepted types: "PDF, Office, CSV, plain text, BibTeX, ZIP, images. 100 MB max."
You can upload in either of two ways:
- Drag and drop — drag one or more files from your computer onto the dashed box, or
- Browse — click anywhere in the box to open your computer's file picker and choose files.
Uploading starts as soon as you drop or choose the files. For each file you'll see its name, a progress bar, and a percentage counting up. You can upload up to 5 files at once.
When it finishes you'll see "File uploaded." (or "2 files uploaded.", etc.), and the new files appear at the top of the list.
Possible messages if something isn't right:
| Message | Meaning |
|---|---|
| File is too large (max 100 MB). | The file is over the per-file limit |
| Too many files at once. | You selected more than 5 files in one go |
| That file type isn't allowed. | The file isn't one of the supported types above |
| Upload failed. | The upload didn't complete (for example, the workspace storage allowance is full) |
Note: If you don't have editing rights, you won't see the upload box at all — the Files screen is read-only for your role, and you can still download anything that's there.
The file list, downloading, and removing files#
Each file sits on its own row showing an icon for its type, the file name, and a details line with the file size, who uploaded it, and when. If a file was stored without a name it appears as "(untitled)".
Downloading
- Click the Download button on the file's row.
- The file opens in a new browser tab. Depending on the type, it either previews (for example a PDF or image) or downloads to your computer.
Any project member can download, regardless of role.
Tip: Each Download link is generated fresh when you click it and stays valid for about an hour. If you copy a download link and it stops working later, just come back and click Download again.
Removing (archiving) a file
Members with editing rights (Principal Investigator, Co-Investigator, Fellow) see an archive (box) button at the end of each row — you can archive any file, even one a teammate uploaded.
- Click the archive icon on the file's row.
- Confirm when asked "Archive this file?".
The file is removed from the list, its stored copy is cleared, and you'll see "File archived." If you try to archive without permission you'll get "You can't archive this file."
Note: Archiving frees up the space the file was using against your workspace's storage allowance.
Communication — Team Chat#
Every project in CoPub has its own built-in chat, so your whole team can talk in one place instead of scattering across email and messaging apps. You'll find it under the Communication tab of any project you belong to. This section walks you through everything chat can do: group conversations, private one-to-one messages, replies, reactions, mentions, voice notes with automatic transcription, file attachments, search, and more. Chat works fully in both English and Arabic, including right-to-left layout.
Getting your bearings#
When you open Communication, the screen splits into two parts:
- The threads rail (on the left) — your list of every conversation in this project: the main project chat, any named channels, and your private direct messages.
- The conversation pane (on the right) — the messages in whichever conversation you've selected, with the message box at the bottom for writing.
On a phone or narrow screen, the rail is hidden to save space. Tap Show threads to slide it open and Hide threads to tuck it away again.
Tip: The conversation you had open is remembered when you arrive from a notification — clicking a chat notification drops you straight into the exact conversation that it came from.
The three kinds of conversations#
Chat has three types of conversations, each with its own privacy rules. The rail and the header of each conversation always tell you which kind you're in.
| Conversation | Who can see it | How it's labelled |
|---|---|---|
| Project chat | Everyone on the project can read and write. Created automatically with the project — there's always exactly one. | "Project chat", shown with a # icon. Subtitle: "Everyone on this project can read & write here." |
| Channels | Everyone on the project, same as project chat — but focused on one topic you name. | The channel name with a # in front (e.g. #recruitment). Subtitle: "Project channel — visible to everyone on this project." |
| Direct messages (DMs) | Only the two people in the conversation. Completely private. | The other person's name, shown with a person icon. Subtitle: "Direct message — only the two of you can read this." |
Note: Direct messages are only possible between people who share at least one organization with you. This keeps private messaging inside your own institution.
Sending a message#
- Select a conversation from the rail.
- Click into the message box at the bottom — it says Write a message….
- Type your message. Press Enter for a new line, or use ⌘/Ctrl + Enter to send.
- Click the round send button (the paper-plane icon on the right of the box) to send.
Your own messages appear on the right in a soft highlight; everyone else's appear on the left. Each message shows the author's name and the time it was sent. When there's nothing in a conversation yet, you'll see "No messages yet. Be the first to say something."
Tip: An empty message won't send on its own — but if you've attached a file with no text, that's fine; the message will carry the attachment.
Mentioning a teammate with @#
To get someone's attention, type @ followed by their name. A small list of project members pops up as you type — keep typing to narrow it, then pick the person. Their name is inserted into your message, and when you send it they receive a notification letting them know they were mentioned, even if they've muted the busier conversations.
Tip: Mentions are one of the surest ways to reach someone — a mention always notifies, so use it when you genuinely need a specific person to look.
Replying to a specific message#
When a conversation gets busy, you can reply directly to one message so everyone knows exactly what you're responding to.
- Hover or look under the message you want to answer and click Reply.
- A small Replying to [name] banner appears just above the message box, showing a preview of what you're answering. (Click the ✕ on the banner to cancel and go back to a normal message.)
- Type your reply and send it as usual.
Your reply appears in the normal flow of the conversation with a small quote-chip at the top showing who you replied to and a snippet of their message. Clicking that quote-chip jumps you straight up to the original message. If the original is far back in the history, you'll see a gentle note: "That message is further up — load older messages to jump to it."
Note: You reply to an original message — you can't reply to a reply. This keeps threads one level deep and easy to follow.
Reacting with emoji#
Sometimes a quick reaction says enough. Under any message, click React to open a small picker with six quick emoji:
| 👍 | ❤️ | 😆 | 🎉 | 👀 | ✅ |
|---|
Click one to add it. Reactions collect into little chips beneath the message showing the emoji and a running count; your own reaction is highlighted. Click a chip again to remove your reaction (a toggle).
In a group conversation (project chat or a channel), if you're the author of the message, clicking a reaction chip on your own message opens a Reactions window that lists exactly who reacted with each emoji — handy for seeing who's on board. In direct messages, and on other people's messages, clicking a chip simply adds or removes your own reaction.
Editing and deleting your own messages#
You can fix or remove your own messages for a limited time.
- Edit — Under your message, click Edit, change the text, and click Save (or Cancel to back out). An edited message is quietly marked edited next to its timestamp.
- Delete — Click Delete and confirm "Delete this message?". The message is replaced with "(message deleted)" so the conversation still reads sensibly, but your words are gone from view.
Note: Both Edit and Delete are available for 24 hours after you send a message. After that, the options disappear and the message is final. If you try to save an edit past the window you'll see "Edit window expired (24 hours)."
Attaching files#
To share documents, images, PDFs, or other files:
- Click the paperclip icon to the left of the message box (Attach files).
- Pick up to 3 files — each up to 25 MB.
- Your chosen files appear as chips above the message box, each showing its name and size. Remove one before sending with its ✕.
- Add a message if you like, then send. The files appear as tidy chips under your message; anyone in the conversation can click a chip to open or download the file.
If a file is too big or its type isn't allowed, you'll get a clear message such as "File exceeds the 25 MB chat-attachment cap.", "That file type isn't accepted in chat.", or "You can attach up to 3 files per message."
Tip: If you attach an audio file, CoPub treats it as a voice message — it gets its own bubble with an audio player (and, where enabled, a transcript), exactly like a recording made in the app.
Voice messages#
You can send a voice note two ways: record one right in your browser, or attach an audio file (as above).
To record in the browser:
- With the message box empty, click the round microphone button on the right (Record a voice message). Your browser will ask permission to use your microphone the first time.
- The message row turns into a recording bar: a red pulsing dot, a running timer (0:00), and Recording….
- When you're done, click the send (paper-plane) button to stop and send, or the ✕ to cancel and throw the recording away.
Recordings can be up to 5 minutes long. Once sent, the voice message appears in the conversation with a built-in audio player — press play to listen.
Automatic transcription. If transcription is enabled for your workspace, CoPub automatically turns each voice message into text. While it's working, the message shows (transcribing…); when it's ready, a compact Transcript (N words) link appears. Transcription understands both English and Arabic.
Opening a transcript. Click the Transcript link to open the full text in a focused window, so a long voice memo never clutters the conversation. In that window you can:
- Listen with the audio player and Download audio.
- Copy the whole transcript to your clipboard.
- Download the transcript on its own as a .txt file, or the audio + transcript together as a .zip.
- Edit the transcript to correct any mistakes — available to the person who recorded it, within the same 24-hour window as text edits. Click Save transcript when done.
- Close the window with the ✕, the Close button, clicking outside it, or pressing Esc.
Note: If transcription isn't enabled for your workspace, voice messages still send and play perfectly — they simply arrive as audio only, with no transcript link.
Seeing who's typing#
When someone in the conversation is writing, a small line appears just above the message box — for example "Dr. Salim is typing…", "Dr. Salim and Aisha are typing…", or "3 people are typing…". It clears on its own a few seconds after they stop.
Read receipts — who's seen your message#
Chat shows you when your messages have been read, so you know they've landed.
- In a direct message: your sent message shows a small Seen with a check-badge once the other person has read it.
- In a group (project chat or channel): your message shows Seen by N. Because it's your message, you can click Seen by N to open a list of exactly who has read it.
- On other people's group messages: you'll see a plain Seen by N count (not clickable).
Who's online#
In your Direct messages list, a small green dot next to a person's icon means they're currently online in this project, so you know when you're likely to get a quick reply.
Reading older messages and jumping to the latest#
Long conversations don't all load at once. When there's more history above what's shown, a Load older messages button sits at the top — and as you scroll up, older messages load automatically, so you can keep scrolling back through the whole conversation.
When you've scrolled up and new messages arrive, a round down-arrow button appears in the corner. Click it to jump straight back to the latest message.
Searching a conversation#
Every conversation has its own search box in the top-right of the header (Search this conversation).
- Start typing — results appear live as you type.
- Each result shows who wrote it, when, and a short snippet around your search term.
- Click the ✕ beside the box to close the results and return to the full conversation.
Search looks through everything in the open conversation — including the text of voice-message transcripts — and works equally well in English and Arabic. If nothing matches, you'll see "No messages match your search."
Tip: Search covers whichever conversation you have open. To search a different channel or DM, open that conversation first, then search there.
Named channels — creating and archiving#
Channels let you split a busy project into focused, topic-named spaces (for example #ethics-approval or #data-collection). Everyone on the project can see and post in every channel.
To create a channel (available if creating channels is enabled for your role):
- In the rail, click the + next to the Project heading.
- Type a Channel name (up to 200 characters) and press Enter.
- The new channel opens right away and appears in your rail with a # in front of its name.
To archive a channel:
- Open the channel and click Archive in its header.
- Confirm "Archive this channel? Its history is kept but it leaves the sidebar."
Archiving is available to the person who created the channel and to project members who can manage members. An archived channel disappears from everyone's rail (anyone viewing it is gently moved back to the main project chat), but none of its history is lost — and its name becomes free to use again. If you don't have permission, you'll see "You don't have permission to do that."
Note: The main Project chat can't be archived — it's always there as the project's home conversation.
Starting a direct message#
- In the rail, click the + next to the Direct messages heading.
- In the Start a direct message window, search by name or email. The list shows the people on your projects and, if you belong to an organization, its members. An External member sees only the people on their projects, by name.
- Click a person to open (or reopen) your private conversation with them.
If something isn't possible you'll get a clear reason: "You can't DM yourself.", "That user isn't in any of your organizations.", or "User not found." Before you've started any, the DM list simply reads "No direct messages yet."
Unread badges and notifications#
- Unread badges: any conversation with messages you haven't read yet shows a small numbered badge in the rail. Opening a conversation clears its badge automatically.
- Notifications: CoPub lets you know about the messages that matter most through the notification bell:
- Direct messages always notify you — they're personal and intentional.
- @mentions always notify you — even in busier conversations.
- Replies to your messages notify you.
- General chatter in project channels is kept quieter by default, so busy channels don't flood your notifications. You'll still see the unread badges in the rail.
Each new message you're notified about counts on its own, so your notification badge reflects how many messages are waiting — not just how many conversations.
Read-only conversations#
If your role on a project doesn't include posting to chat, you can still read everything, and the message box is replaced with a short note: "You have read-only access to this chat."
Tip: If you believe you should be able to post but can't, ask a project owner or administrator to check your role for this project.
Meeting Minutes#
Every project in CoPub has its own Meetings space — a running, searchable timeline of your team's meetings. You can write minutes by hand (agenda, discussion notes, decisions, and action items), invite people from your project team as attendees, turn any action item into a real task with a single click, and — if it's enabled for your workspace — upload an audio recording and let CoPub transcribe it and draft the structured minutes for you. This section walks through everything on the page, step by step.
Note: Most of what follows (creating meetings, adding action items, uploading recordings) is available to project members who can contribute. A few buttons only appear when you have the matching access — those are called out where they come up. If a button isn't visible to you, you likely don't have permission for that action on this project.
Opening the Meetings space#
- Open your project and go to its Meetings section.
- At the top you'll see the heading Meetings with a short reminder that minutes are "searchable by keyword, date, and attendee."
- On the right is the New meeting button (visible if you're able to contribute to the project).
- Below the heading are a search box and an attendee filter, and beneath those, the meeting timeline itself.
If the project has no meetings yet, the timeline shows: "No meetings yet. Create the first one to start the project timeline."
Creating a meeting#
- Click New meeting. A form opens directly on the page.
- Fill in the fields:
| Field | Required? | What it's for |
|---|---|---|
| Title | Yes | A short name for the meeting (up to 300 characters). |
| Date & time | Yes | When the meeting was (or will be) held — pick a date and a time. |
| Agenda | No | The planned topics. Free text, multi-line. |
| Discussion notes | No | What was actually discussed. Free text, multi-line. |
| Decisions made | No | The conclusions the team reached. Free text, multi-line. |
| Attendees | No | Tick the project members who took part (see below). |
- Under Attendees, you'll see a checkbox for each current member of the project team. Tick everyone who attended. Only people who are members of this project appear here — that keeps your attendee list scoped to the actual team.
- Click Create meeting to save. The new meeting appears at the top of the timeline and opens up automatically so you can review it.
Tip: You don't have to fill everything in up front. Title and date/time are the only required fields — you can leave agenda, notes, and decisions blank and come back to fill them in later, or (if AI drafting is on for your workspace) let a recording fill them for you.
Note: The agenda, notes, and decisions fields each hold a large amount of text (tens of thousands of characters), so you're free to paste in full write-ups. Dates and times are shown in a plain 24-hour format like
2026-07-09 14:30.
If something can't be saved, a short message appears in red at the bottom of the form (for example, if the title is empty). Click Cancel at any time to close the form without saving.
The meeting timeline#
Every meeting shows up as a card in the timeline, newest meeting first (ordered by the date and time you entered).
- Each card shows the title, the date and time, and — if you added attendees — the list of attendee names next to the date.
- If a recording is being processed or is done, a small status badge appears on the right of the card (see Recordings and automatic minutes below).
- Click a card to expand it and see the full minutes: agenda, discussion notes, decisions, action items, and the recording area. Click it again to collapse it. Only one meeting is expanded at a time.
Inside an expanded meeting, sections that are empty are simply hidden — so if you never filled in "Decisions," that heading won't clutter the card.
Searching and filtering meetings#
Two controls above the timeline let you narrow things down, and they work together:
- Search minutes — start typing in the search box. Results filter as you type (after a brief pause), matching your keyword against the meeting title, agenda, discussion notes, decisions, and even the text of any transcript. So you can find a meeting by a phrase someone said on the recording, not just by its title.
- All attendees dropdown — pick a person to show only the meetings they attended. Choose All attendees again to clear it.
You can combine both — for example, search for "budget" and filter to meetings that a specific colleague attended. Clear the search box to see the whole timeline again.
Tip: Because the timeline is always sorted with the most recent meeting on top, you can browse chronologically without any filter — just scroll.
Action items#
Action items are the follow-ups captured for a meeting. They live inside the expanded meeting card, under Action items.
Adding an action item
- Expand the meeting.
- In the Add an action item… box at the bottom of the action-items list, type the follow-up (up to 2,000 characters).
- Press Enter or click Add. It appears in the list immediately.
Removing an action item
- Click the ✕ next to an item to remove it. (Removing an action item that you'd already turned into a task does not delete the task — the task stays in your project.)
Turning an action item into a task (one click)#
Any action item can become a real, trackable task in your project's task list — no retyping.
- Expand the meeting and find the action item under Action items.
- Click Create task next to it.
- CoPub creates a project task using the action item's text as the task title, links the two together, and shows a brief "Task created." confirmation. The item then displays a green Task created label instead of the button.
Note: The Create task button only appears if you have permission to create tasks in this project. If you don't see it, you can still add and keep action items — you just can't convert them yourself.
Tip: Conversion happens once per item. After an action item shows Task created, clicking around won't make a duplicate task — the link is kept, so the item and its task stay tied together.
Recordings and automatic minutes#
Instead of writing everything by hand, you can upload an audio recording of the meeting. CoPub will transcribe it to text automatically, and — if your workspace has AI minutes turned on — draft the structured minutes for you.
Uploading a recording
- Expand the meeting and find the Recording section.
- Choose an audio file, then click Upload & transcribe.
- You'll see a confirmation — "Recording uploaded — transcribing…" — and the meeting picks up a status badge while it's processed.
Accepted files are audio only: WebM, MP3, M4A, and WAV, up to 100 MB. There's one recording per meeting; uploading again replaces the previous one.
Note: If AI minutes drafting is not enabled for your organization, you'll see a small line under the upload button: "AI minutes drafting is off for your organization — you'll get the transcript only." In that case CoPub still transcribes your audio to searchable text; it just won't auto-write the agenda/notes/decisions draft.
What happens next — the "analysing" state
While CoPub works through your recording, the meeting card shows a status badge so you always know where things stand. During this analysing phase the badge sits in amber and updates on its own — you don't need to refresh the page.
| Badge | What it means |
|---|---|
| Transcribing… (amber) | Your audio is being turned into text. |
| Drafting minutes… (amber) | The transcript is being written up into structured minutes (only if AI drafting is on). |
| Minutes ready (green) | Finished — the transcript (and the AI draft, if enabled) are ready to read. |
| Transcription failed (red) | Something went wrong. Your recording stays attached so you can review or try again. |
A meeting with no recording and nothing in progress simply shows no badge at all.
Reading the transcript and the drafted minutes
- Once processing finishes, the Recording section shows a View transcript link. Click it to expand the full transcript in a scrollable panel.
- If AI drafting ran, CoPub fills in the minutes for you — but only where you left a field blank. If you'd already written an agenda, notes, or decisions yourself, your words are kept exactly as they are; the AI never overwrites what a person wrote. Any action items the AI identifies are added to your action-items list.
Tip: This "fill the blanks only" behaviour means you can safely jot a few notes by hand and upload a recording. Your notes stay put, and the AI just fills in whatever you left empty and suggests action items — which you can then turn into tasks with one click.
Editing and deleting a meeting#
At the bottom of an expanded meeting card (if you have permission to contribute) you'll find:
- Edit — reopens the same form, pre-filled with the meeting's current details and attendees, so you can adjust the title, date/time, agenda, notes, decisions, or who attended. Click Save changes when done.
- Delete — removes the meeting and its minutes. You'll be asked to confirm first ("Delete this meeting and its minutes?"). Deleting is limited to the person who created the meeting or a project manager.
Note: Everything you do here — creating, editing, deleting a meeting, and converting action items — is recorded in your project's activity history, so there's always a clear trail of who changed what.
Smart Lab Notebook#
The Smart Lab Notebook is your private research workspace inside each project — a single, scrollable feed where you capture ideas the moment they happen and let the AI help turn them into something you can share with your team. You reach it from a project's Notes section. At the top you'll see the title Smart Lab Notebook and the reminder "Your private research workspace · AI-powered insights."
Everything you write starts out visible only to you. You decide, entry by entry, what (if anything) the rest of your team ever sees.
Note: Adding, editing, sharing, and deleting entries are available when you have permission to contribute to the project. If you have read-only access, you'll still see the feed and can open cards, but the creation tiles and action buttons won't appear.
Your Private Workspace#
Right under the heading is a highlighted banner: "Private Workspace. Everything here is private until you choose to share. Capture ideas freely — AI will help you turn them into polished updates for your team." That banner is the promise the whole notebook is built on.
- Private by default. Every note, picture, link, and voice memo you create is visible only to you — even inside a shared project where teammates have their own notebooks. Your colleagues cannot see your private entries.
- Sharing is a deliberate, separate step. Nothing reaches the team until you press Share on that specific entry (covered below).
- Sharing takes a snapshot. When you share, the team sees a copy of the entry as it looked at that moment. If you later edit your private version, the team's copy does not change — so you can keep refining your own notes without silently rewriting what the team already read.
At the very bottom of the feed you'll also see a quiet reminder: "Entries are private to you until shared. AI analysis runs in-region."
The three tabs#
The feed has three tabs. Click a tab name to switch; the one you're on is underlined.
| Tab | What it shows |
|---|---|
| Mine | Your own private entries — everything you've captured, newest first. This is your day-to-day workspace. |
| Team | The shared feed — snapshots that you or your teammates have chosen to share. Visible to everyone on the project. |
| Archived | Entries you've set aside. A small number next to the word Archived tells you how many are in there. |
Tip: Empty tabs tell you what to do next — "No private notes yet — add one above," "Nothing shared with the team yet," or "Nothing archived yet."
Adding an entry: the four capture tiles#
On the Mine tab, four tiles sit near the top. Each opens its own simple pop-up window (a "modal") for one kind of capture:
| Tile | Use it for | Note |
|---|---|---|
| Text Note — Quick thoughts | A written note or idea | |
| Insert Picture — Upload or camera | A photo, screenshot, or diagram | Take a photo or upload a file |
| Insert Link — URL or DOI | Saving a web page, paper, or dataset | Add a note on why you saved it |
| Voice Note — Record audio | Talking through an idea hands-free | Record live or upload an audio file |
Every capture window has a Tags field at the bottom — type comma-separated tags (for example mice, dosing, week3) to make entries easy to find later. Press Save & Analyze with AI to keep the entry, or Cancel (or the ✕, clicking outside the window, or the Esc key) to close without saving.
Text Note#
- Click Text Note.
- Type a Title and/or a Note. (Formatting like Markdown is supported in the note body.)
- Add Tags if you like.
- Press Save & Analyze with AI.
Note: A text note needs at least a title or some note text. If both are empty you'll see "Add a title or a note first."
Insert Picture#
- Click Insert Picture.
- Choose a source:
- Take Photo — "Opens the camera on mobile." On a phone or tablet this launches the camera so you can snap a bench setup, a whiteboard, or a gel image on the spot.
- Upload Image — pick an existing file. Accepted formats are PNG, JPEG, GIF, and WEBP.
- Optionally add a Caption (this becomes the entry's title) and a Description.
- Add Tags if you like, then Save & Analyze with AI.
Tip: You can attach up to 8 images, each up to 10 MB. As each file uploads you'll see its name and a percentage; click the ✕ beside a file to remove it before saving. If a file is the wrong type or too big, a clear message tells you (for example "Image is too large (max 10 MB)" or "Only PNG, JPEG, GIF, or WEBP images").
Note: You can also save a picture entry with just a caption and no image, and add photos to it later — see Adding more images to a picture entry below.
Insert Link#
- Click Insert Link.
- In URL or DOI, paste the web address or DOI you want to keep. It must be a normal
http://orhttps://web address. - In Why is this relevant / what to remember, jot a sentence about why this link matters — this note is saved with the link and shown as "Why saved."
- Add Tags, then Save & Analyze with AI.
The notebook automatically fetches the page's title and description in the background, so a link you save with a bare URL fills in with a readable title and summary shortly after.
Note: For your safety, links must point to real, public web addresses. Private, internal, or local addresses are refused with a plain message (for example "Private/internal URLs aren't allowed," "Localhost URLs aren't allowed," or "URL must use http:// or https://").
Voice Note#
- Click Voice Note.
- Choose a source:
- Record — "Up to 10 min; AI transcribes on stop." Press Start recording; a red dot and a running timer appear. When you're finished, press Stop & transcribe (or Cancel to discard). The recording uploads and is automatically turned into text.
- Upload Audio — "m4a, mp3, or wav." Choose an existing audio file; "the upload starts immediately and is transcribed like a recording."
- That's it — there's no Save button for voice. Once the audio arrives, the entry is created for you and transcription begins.
Tip: Recordings can run up to 10 minutes; uploaded audio can be up to 25 MB. If your browser blocks the microphone you'll see "Microphone access was denied," and older browsers that can't record show "Recording isn't supported in this browser" — in that case, use Upload Audio instead.
Reading your feed: collapse and expand#
The notebook is a single-column feed of collapsible cards, newest at the top. Each card shows an icon for its type, its title, a short preview, any tags, and the time it was created.
- The newest entry opens automatically when you arrive, so your most recent thought is right there.
- Click anywhere on a card's header row to open (expand) or close (collapse) it. The little arrow (chevron) on the right rotates to show the state. Clicking the action buttons on the row does not toggle the card — only the row itself does.
- Expand all / Collapse all. The button at the top-right of the toolbar flips between the two — its label always tells you what it will do next. If any visible card is closed, it reads Expand all; once everything is open it reads Collapse all.
Tip: Opening an image or voice card loads its pictures and transcript on demand, so the feed stays fast even with lots of entries.
Searching your notebook#
Use the Search notebook… box in the toolbar to filter the current feed as you type (results update after a brief pause).
- On the Mine tab, search looks across your entry titles, note text, tags, and the text the AI has pulled out of your images and voice recordings — so you can find a note by a word that was only ever spoken aloud or written on a photographed whiteboard.
- On the Team tab, search matches the shared snapshots' titles and text.
Tip: Because search reaches into AI-extracted text, transcribing a voice note or analysing an image effectively makes that content searchable.
What the AI does with your captures#
Two kinds of AI reading happen right on your entries. Both show a spinning "Analysing…" indicator while they work, and both save their results onto the entry so they never have to run again.
Voice transcription (automatic). Every voice note is transcribed for you. While it's working the open card shows "Analysing…"; when it's done, the text appears under a ✦ AI Transcript heading. If transcription ever fails, the card shows the reason and a Retry transcription button so you can try again — your original audio is never lost.
| On a voice card you may see | What it means |
|---|---|
| Analysing… | Your audio is uploading or being transcribed — hang tight. |
| ✦ AI Transcript + text | Transcription finished; the words are ready (and searchable). |
| An error message + Retry transcription | Something went wrong; press the button to run it again. |
Image reading / OCR (one click). Open an image entry and, beneath each picture, press Analyse. The AI reads the image — including any text in it (OCR) — and shows the result under a ✦ AI read (OCR) label. The button then becomes Re-analyse if you ever want a fresh read, and shows Analysing… while it works.
Note: Image analysis appears if AI assistance is enabled for your workspace. If it isn't, the Analyse button simply won't show, and pressing it (if forged) is safely refused.
Adding more images to a picture entry#
- Open the picture card.
- Press Add images.
- An uploader appears — choose one or more files (same formats and limits as above).
- Each image attaches to the card. Hover an image and click the ✕ to remove it (you'll be asked to confirm).
The ✦ Ask AI menu#
Open any of your entries and, if AI assistance is enabled for your workspace, you'll find a ✦ Ask AI button at the bottom of the card. It gives you a research assistant focused on that one entry — it answers using only that entry's own content (its title, note text, transcript, and any image reading), so replies stay grounded in what you actually captured.
- Press ✦ Ask AI to open the panel ("How can I help with this?").
- Choose one of the quick actions, or type your own question:
| Option | What it does |
|---|---|
| Explain | Explains the entry in plain language. |
| Critique | Points out weaknesses, gaps, methodological concerns, and what to check next. |
| Ask anything about this entry… | A free-text box — type any question about the entry and press Ask. |
- While the assistant works you'll see "Thinking…". The answer then appears in a running thread right inside the card, with your questions and the AI's replies stacked in order, so you can keep a conversation going about that entry.
Note: The assistant is a research aid, not a medical device — it won't give diagnostic or clinical-decision advice, and it only ever discusses the single entry you opened, never your other notes.
Editing an entry#
- On the Mine tab, open (or find) the entry and press Edit on its row.
- The same capture window reopens, pre-filled with your existing content.
- Make your changes and press Save changes.
Note: Editing changes your private copy. If you had already shared the entry, the team keeps the earlier snapshot — your edits don't rewrite what they've seen.
Sharing, archiving, deleting, and restoring#
Each of your entries moves through a simple lifecycle, and the buttons on the card change to match its state. On the Mine tab, active (non-archived) entries show an Edit button plus the actions below.
| State | What it means | Available actions |
|---|---|---|
| Private | Only you can see it | Share (send a snapshot to the team) · Delete (remove permanently) |
| Shared | A snapshot is on the Team feed (a small Shared badge appears on the card) | Archive (set it aside while keeping the team's copy) · Unshare (on the Team tab, within 24 hours) |
| Archived | Set aside and hidden from Mine | Restore (bring it back) |
Share to the team
- Press Share on a private entry.
- You'll see "Shared to team," a Shared badge appears on the card, and a snapshot shows up on the Team tab for everyone on the project.
Delete (private entries only)
- Press Delete on a private entry.
- Confirm "Delete this private entry permanently?" — this cannot be undone, and it also removes the entry's attached images.
Note: Delete is deliberately available only for private entries. If an entry has been shared, you'll be told "Shared entries can't be deleted — archive instead to keep team history," and an archived entry asks you to "Restore the entry before deleting it." This protects the record your team relied on.
Archive (once shared)
- Press Archive on a shared entry.
- It moves to the Archived tab (the team's shared snapshot stays put). You'll see "Entry archived."
Restore
- Go to the Archived tab.
- Press Restore on the entry. You'll see "Entry restored" and land back on your Mine tab.
Unshare (a short grace period)
If you shared something by mistake, you can pull it back — but only for a limited time.
- Go to the Team tab and find the entry you shared.
- If you're still within 24 hours of sharing, an Unshare button appears (only on entries you shared).
- Press it and confirm "Unshare this entry from the team feed?" — it disappears from the team feed.
Note: After 24 hours the Unshare button is gone, and you'll be told "Unshare window has closed (24h after share). Archive the source entry instead." This keeps an honest record of what the team has already seen.
Voice notes in progress#
If you record or upload voice while other transcriptions are still running, a "Voice notes in progress" banner appears near the top of the feed, listing each one as either Transcribing (a spinning indicator) or Pending upload. It's there so you never lose track of a recording that's still being processed — and it rebuilds itself even if you refresh or briefly lose your connection. When a transcription finishes, its card updates on its own and you'll see "Transcription complete."
Comments & Sharing Documents#
Writing a paper is a team sport. CoPub lets your collaborators leave comments right on the text of a document — pinned to the exact words they're reacting to — and lets you hand a document to someone outside your project (a supervisor, a co-author, a journal reviewer) through a simple web link, with no CoPub account required on their end. This section walks through both: commenting inside the editor, and sharing a document out.
Everything here happens inside the document editor (open a project, then the Editor tab). Two buttons in the editor's toolbar do the work: a Comments button (a speech-bubble icon) and a Comment on selection button next to it. Sharing has its own Share button (a chain-link icon), which appears only if you're allowed to share.
Part 1 — Commenting on a document#
Who can comment#
Anyone who can open the project can read and take part in comment threads. The finer permissions depend on your role on the project:
| What you want to do | Who can do it |
|---|---|
| Read comments, start a thread, reply | Anyone on the project (any role) |
| Resolve or reopen a thread | The person who started the thread, or an editor (Principal Investigator, Co-Investigator, Fellow) |
| Edit a comment | Only the person who wrote it |
| Delete your own comment | You (its author) |
| Delete someone else's comment | Principal Investigator or Co-Investigator |
Note: Statisticians and Coordinators can comment and reply freely — commenting isn't the same as editing the document. They can resolve or reopen only the threads they started themselves.
Leaving a comment on a piece of text#
Comments are always anchored to the text you select, so everyone reading the thread can see exactly what it refers to.
- In the document, highlight the words, sentence, or paragraph you want to comment on.
- A small floating toolbar appears over your selection. Click Comment on it. (You can also click the Comment on selection button up in the editor toolbar — it does the same thing.)
- The Comments panel slides in from the right, already in "new thread" mode. At the top of it you'll see your selected text shown as a grey quoted snippet, so you can confirm you highlighted the right thing.
- Type your comment in the Add your comment… box.
- Click Post comment. Your comment appears as the first message in a new thread, marked Open.
Tip: If you click Comment on selection without highlighting anything first, CoPub gently reminds you: "Highlight some text in the document to start a comment thread." Highlight, then try again.
Tip: The highlighted words stay marked in the document as the thread's anchor. If you later edit or delete that exact text, the comment isn't lost — see "When the highlighted text changes" below.
Mentioning a teammate#
Inside any comment or reply box you can pull a colleague's attention directly:
- Start typing @ followed by a name.
- A small list of your project's active members appears — pick one.
- When you post, their name becomes a link in the comment, and they'll be notified (unless they've muted the thread).
Reading and replying in a thread#
Open the Comments panel any time with the speech-bubble Comments button in the toolbar. A small number on that button (its "pill") tells you at a glance how many threads exist — for example 3 means three open threads, and 3 / 5 means three open and five resolved.
Inside the panel:
- Threads are listed oldest first.
- Each thread shows a status badge — Open or Resolved — and the quoted snippet of text it's anchored to.
- Every message shows the author's name and when it was posted. If a message was changed after posting, a small · edited note appears next to the time.
To reply, type in the Reply… box at the bottom of an open thread and click Reply. Your reply is added to the bottom of the thread.
Note: You can only reply to Open threads. If a thread has been marked Resolved, its reply box disappears; reopen it first (see below) to continue the conversation.
Editing or deleting your own comment#
Under any comment you wrote, you'll see Edit and Delete:
- Edit — opens the comment in a text box. Make your change and click Save. The comment now carries a · edited marker so the change isn't silent. (There's no time limit — you can edit an old comment any time.)
- Delete — asks you to confirm, then removes the wording. The comment isn't erased from the thread's history; instead it's shown to everyone as "(comment deleted)" so the conversation still makes sense.
Note: A Principal Investigator or Co-Investigator can also delete a comment written by someone else (for example, to remove something posted in error). The same "(comment deleted)" placeholder is shown.
Resolving and reopening a thread#
When a point has been addressed, tidy it away:
- In the thread header, click Resolve.
- The thread is stamped Resolved, shaded grey, and its reply box closes.
Changed your mind, or the issue came back? Click Reopen on a resolved thread to make it Open and repliable again.
The Resolve / Reopen button only shows up if you're allowed to use it — that is, if you started the thread or you're an editor (PI, Co-Investigator, or Fellow).
Tip: Resolving is the natural way to work through reviewer feedback: reply to discuss, then resolve once the change is made. The resolved threads stay on record (and are counted in the pill) rather than vanishing.
Muting a thread#
If a busy thread isn't yours to follow, you can stop its notifications without leaving the conversation:
- Click Mute (a bell icon) in the thread header to stop being notified about new activity there. The button changes to Muted.
- Click Muted to unmute and start receiving notifications again.
Muting is personal to you — it doesn't change the thread for anyone else.
When the highlighted text changes#
Because a comment is pinned to specific words, editing the document can move or remove those words. CoPub handles this gracefully:
- If the anchored text is edited away, the thread gets an orange Anchor lost badge, with a tooltip explaining "The highlighted text was edited; the anchor is no longer in the document."
- The thread still shows the original quoted snippet, so reviewers can see what was first highlighted and the conversation is never orphaned.
AI-generated review comments#
If your workspace has the AI review feature turned on, running a review can add its own comment threads directly into this panel. They look like normal threads but carry a purple AI · Major or AI · Minor badge to mark how important the AI thinks each point is. You resolve, reopen, and reply to them exactly like any other thread — and your decisions on them are kept even if you run the review again.
Live updates#
The Comments panel stays current on its own. When a collaborator posts, edits, resolves, or deletes a comment in the same document, it appears in your panel without you refreshing the page.
Good to know#
- Empty document / no comments yet — the panel simply invites you to "Highlight some text in the document, then click 'Comment on selection' in the toolbar."
- Thread limit — a single document can hold up to 500 comment threads. If you ever reach that, CoPub will say the document has hit the comment-thread limit; resolve or clear some before adding more.
Part 2 — Sharing a document with a link#
Share links let someone outside your project open a document in their browser — read-only, or read-and-comment — without signing in or having a CoPub account.
Who can share#
Only project editors — Principal Investigator, Co-Investigator, and Fellow — can create or revoke share links, because sharing sends your work outside the project. If you don't see the Share button in the toolbar, your role doesn't include sharing. (Any project member, though, can see that a document has active links.)
Creating a share link#
-
In the editor toolbar, click the Share (chain-link) button. The Share document panel slides in from the right.
-
Under New link, choose an Access level:
Access What the recipient can do View only Read the document. Nothing else. View + comment Read the document and leave comments and replies on it. Can edit Read, comment and edit. Anyone opening an edit link is invited to join the project — accepting turns them into a real project member — or, if they're from outside your organization, an External member of this project only — after which they appear in Members like anyone else and the link is no longer what grants their access. Treat an edit link as an open invitation and set an expiry on it. -
Optionally set an Expires date and time (shown in your own local time). Leave it blank to keep the link working until you revoke it.
-
Click Create link.
The new link appears in the Active links list below, ready to copy.
Note: The panel reminds you plainly: "Anyone with the link can open this document — no CoPub account required." Treat a share link like a key — anyone who has it can open the document, so only send it to people you trust, and set an expiry or revoke it when you're done.
Tip: A document can have up to 50 active links at once — handy when you want to give different reviewers their own link (and revoke them individually). If you hit the limit, revoke a few old ones first.
Copying and managing your links#
Each entry in Active links shows you:
- A badge for its access level — View only or Comment.
- A viewer count — how many distinct people have opened it (e.g. "3 viewers").
- The full web address of the link, with a copy button (the clipboard icon) that puts it on your clipboard in one click.
- When it was created, and — if you set one — when it expires. A link that's past its expiry but not yet swept away is flagged "expiring shortly."
Revoking a link#
To cut off access at any time:
- Find the link in Active links.
- Click Revoke and confirm ("Revoke this link? Anyone holding it will lose access.").
The link stops working immediately — anyone who tries to open it afterward is told the share link is no longer available.
Note: Expiry does this for you automatically. Once a link passes its expiry time, CoPub retires it on its own, and it stops opening the document. If you (the person who created links) ever have your account closed, all the links you created are revoked as part of that.
Two-part "secret key" links#
Some links can be made extra-private by carrying a secret key as part of their web address — you'll notice these have an extra ?s=… piece on the end. With one of these, the public part of the address alone won't open the document; the recipient needs the complete address, secret key included, or they'll simply see "This share link is no longer available."
- The secret is shown to you only once, at the moment the link is made, and is never displayed again — so copy the full address right away and send that.
- These secret-key links (and the ability to rotate — i.e. replace — the secret) are currently created through the CoPub mobile app. Rotating generates a brand-new secret and instantly breaks the old address, which is the fastest way to cut off a recipient while keeping the link itself.
Tip: Rotating a secret is the "change the locks" move: if a secret-key link was forwarded to the wrong person, rotate it and re-send the new address to the people who should still have access. Everyone holding the old address is locked out at once.
Part 3 — What your guest sees#
When someone opens your link, they land on a clean, distraction-free page — just the document, no project menus and no sign-in wall. What they can do depends on the access level you chose.
A view-only link#
- A slim header labels the page Shared as view-only and shows the document's title.
- Below it, the document is presented for reading. That's the whole experience — there's nothing to click or change.
- A small footer notes "Shared via CoPub," and, if you set an expiry, the date the link expires.
A comment-enabled link#
The guest gets the same reading view, labelled Shared for review, plus a Comment on selection button in the header and a Comments side panel.
- Introducing themselves — the first time a guest tries to comment, a small pop-up asks "Tell us who's reviewing." They enter their name (required), and optionally an email (never required). Their name is then shown next to every comment they leave, marked as a guest (e.g. "Dr. Amara (guest)").
- Commenting — they highlight text and click Comment on selection, exactly like a project member, then type and post. They can also reply to any open thread.
- The panel header greets them with "Reviewing as [their name]" so they know how they'll be attributed.
What a guest cannot do (these controls simply aren't shown to them):
- Resolve or reopen threads
- Edit or delete comments
- Mute threads
- See any project navigation, other documents, or member information
Note: Guests can reply only to Open threads. If your team resolves a thread, the guest sees it marked Resolved and can no longer reply to it — reopen it on your side if you want the conversation to continue. Guest comments flow into the very same Comments panel you use inside the editor, and updates pass both ways in real time — a guest's new comment shows up in your editor without a refresh, and vice-versa.
Tip: If a link expires or is revoked while a guest is mid-visit, CoPub catches it: the moment they try to post, they're told the link has expired and are sent away, so no comment is ever posted to a document you've stopped sharing.
Part 4 — Publishing a document#
Sharing sends a private link to specific people. Publishing puts a read-only snapshot of a finished document on a stable public page — useful for a preprint-style link you can hand to anyone. Publishing is available only when a workspace administrator has enabled publishing for your organization.
- In the editor, open the Share modal and switch to the Publish tab.
- Work the pre-publish checklist — each co-author confirms, the document must have no unresolved review flags, and a sign-off is recorded. The Publish button stays disabled until the checklist passes.
- Click Publish. CoPub renders the document once into a snapshot and gives you a public URL. The published page shows the title and a member byline; edits you make afterward do not change the published page until you Republish.
- Unpublish is instant and takes the page down immediately.
What readers can and can't do: a published page is a static, read-only snapshot — no editing, no comments, no access to your project. It is served with no-index headers by default, so it won't appear in search engines. A short changed-since-publish notice reminds you when your live document has moved on from what's published.
Learning hub#
CoPub has a built-in learning hub — short, practical tutorials (with real-app screenshots) that walk you through the platform, one task at a time.
Where to find it:
- Learn CoPub in your account menu (the ⚙ options dropdown).
- The "Explore the tutorials" link on a new document's onboarding panel.
- A Learn link in your dashboard header.
How it works: tutorials are grouped by area — Getting started, Writing & AI, References & Library, Review, and Collaboration & Sharing. Open any one to see numbered steps and a screenshot of the real screen. Mark a tutorial done and the hub tracks your progress (e.g. "3 of 5 completed") so you can see what's left.
The AI Assistant Suite#
CoPub includes a set of AI helpers built for research writing: a chat that answers questions about your documents, a multi-step research assistant, writing help while you type, one-click editing and reviewing, chat with a PDF, image reading (OCR), and voice transcription. This section walks through every one of them.
Two things are true of the whole suite, so it helps to know them up front:
- These are writing and research aids — never medical advice. Every answer, review, and summary carries a reminder to verify facts and citations yourself, and the assistant is instructed to decline diagnosis, treatment, dosing, prognosis, or any clinical decision-making. Confidence scores you see measure how well your own cited sources support a sentence, never whether something is clinically correct.
- Every AI tool is on by default; your administrator can switch one off. You do not need to request access. If a button described here isn't visible, or you see "…isn't enabled for your workspace," someone has explicitly turned that one off for the whole workspace — nothing is broken, and the Admin Panel → Feature flags page shows which. Note that being switched on is not the same as being configured: if the buttons are all present but every AI action errors, the workspace's AI credentials are missing, which is an operator fix.
Note: Almost all AI features live in the document editor (open a project, then open a document). A few live elsewhere: chat-with-PDF is in the PDF reader, image reading and voice notes are in the notebook, and meeting transcription is in Meetings. Each is called out below.
Where to find AI in the editor#
When you open a document, look at the toolbar running along the top and right of the editing area. The AI tools appear as small icon buttons, each with a tooltip: AI edit selection, AI outline, AI chat, Suggest citations, AI review, and (in beta) Section prompts. Two small status chips also appear:
- An AI credits chip — hover it to see "AI credits remaining this period."
- A plan chip (e.g. Free) — "This project's AI plan — click to manage."
Tip: After many AI actions a tiny prompt appears asking "What was good?" with quick chips — Accurate, Well-written, Fast — plus a Dismiss (×). Tapping one sends anonymous feedback that helps tune the assistant. It's entirely optional.
Chat about your project#
AI chat opens a conversation panel about the document you're in. Unlike a generic chatbot, it is grounded in your own material: it reads the most relevant passages from your document and your project's indexed sources before answering, and it's told to say so plainly when your material doesn't contain the answer rather than inventing one.
- Click the AI chat button in the editor toolbar to open the chat panel.
- Type your question in the box at the bottom — placeholder "Ask about this document…"
- Press Send (or Enter).
- While it works you'll see "Thinking…"; the answer then appears in the thread.
- The answer is formatted (headings, bold, lists). Each source label in it — L1 for a published paper found by search, R1 for a paper in your library, 1 for a passage of your document — links to its line in the list under the answer, which names one source per line; hover a label to see its title.
- Add to document puts the formatted answer into your document. Each paper it cites becomes a real citation, and a paper found by search is added to your library; a paper that cannot be cited is named by its title, in quotes, where its label was.
A short disclaimer sits beneath the box as a standing reminder that answers are AI-generated writing assistance, not medical advice.
Note: Your chat threads are private to you, even on a document you share with collaborators. Teammates open the same document but never see your questions or the assistant's answers to you.
Deep research (multi-step research assistant)#
Deep research is a more powerful mode of the same chat box. Instead of a single answer, it works like a research assistant: it plans the question into several focused sub-questions, searches for each (in your library and, if you allow it, the web), then synthesises a single written report with inline citations.
- In the chat panel, type your question, then choose Deep research instead of the normal Send. (Its tooltip reads "Multi-step research: plan → search → cited report.")
- A short consent step appears first. If web search is available to your workspace, you'll see a Search the web toggle:
- Leave it off to research using only your own library — nothing leaves your workspace.
- Turn it on only if you want external sources included. A note spells out the trade-off: "Your question is sent to an external search provider."
- Click Run research.
- While it runs you'll see "Researching — planning, searching, writing…"
- The finished Research report appears with:
- Inline citation markers linking each claim to a numbered finding.
- A "How this was researched (N steps)" breakdown so you can see the plan it followed and which searches ran.
- A Sources list.
- A Dismiss (×) to close the report.
Note: Web search is consent-based per question — turning it on for one report does not leave it on for the next. If web search isn't enabled for your workspace, or you leave the toggle off, deep research simply runs on your library alone.
Autocomplete while you type#
When enabled, autocomplete offers a short, greyed-out continuation ("ghost text") as you write — a natural next clause or sentence.
- Just keep typing. When a suggestion appears in grey after your cursor, you can:
- Press Tab to accept it (Accept autocomplete), or
- Press Shift+Tab to try again — discard the suggestion and generate a fresh one at the same spot without retyping, or
- Press Esc to dismiss it (Dismiss suggestion), or
- Simply keep typing to ignore it.
Two things worth knowing:
- Privacy by design: only the text immediately before your cursor is sent to generate a suggestion — never your whole document.
- You're only charged when you accept. Generating suggestions as you type is free; a small credit cost applies only to text you actually keep by pressing Tab.
Section prompts (beta — guide the autocomplete)#
If Section prompts is enabled (it's marked BETA), you can tell the assistant what each section of your document is meant to cover, and autocomplete will follow that guidance.
- Click Section prompts in the toolbar to open its panel.
- For each heading in your document, a box appears: "What should this section cover?" (If you have no headings yet, you'll be prompted to add some first.)
- Type a one-line brief per section — e.g. what the Methods section should include.
- Click Save.
The panel's helper text sums it up: "Tell the AI what each section should cover — autocomplete follows it."
Improve a selection (AI edit)#
AI edit rewrites a passage you've highlighted. Select some text and either use the toolbar's AI edit selection button or the AI edit action on the floating selection toolbar that appears over your highlight.
You then choose how to transform it — a one-click preset, or your own instruction:
| Preset | What it does |
|---|---|
| Paraphrase | Rewrites in different words, keeping the meaning and academic tone |
| Simplify | Makes it clearer and easier to read, without changing the meaning |
| Expand | Adds detail and supporting explanation, in the same tone |
| Make concise | Tightens it without losing any key information |
| More formal | Rewrites in a more formal, academic register |
| Proofread | Fixes only grammar, spelling, and punctuation, leaving your wording intact |
To use a custom instruction instead, type it in the box — placeholder "Instruction, e.g. Rewrite in active voice" — and run it.
The result is shown as a suggestion; nothing changes until you decide:
- Review the proposed rewrite.
- Click Accept to replace your selection, or Discard to keep your original.
Tip: Reuse an instruction you type often by clicking Save a prompt — give it a Name and the Instruction text, then Save prompt. It then appears under Saved prompts for one-click reuse, and you can remove one anytime with Delete prompt. Saved prompts are private to you within your organization. See Saved prompts below.
Build an outline#
AI outline proposes an ordered structure of section headings for a topic — a scaffold to write into. It suggests structure only; it does not write the content.
- Click AI outline in the toolbar.
- Provide the topic.
- The assistant returns a logically ordered set of main sections and subsections (typically four to ten main sections).
- The headings are inserted into your document as real headings, ready for you to fill in.
Suggest citations#
Suggest citations (the Cite action on the selection toolbar) recommends references from your own project library to support the passage you're writing.
- Select the sentence or passage you want to support.
- Click Cite (or Suggest citations).
- A Suggested citations panel lists the most relevant references from your library, most relevant first.
- Pick one to insert a real citation marker into your text.
Note: This tool never makes up a reference. It only ever suggests references that genuinely exist in your library and that you're allowed to see — so a citation it inserts always points at a real source. If your library is empty (or you can't read it), you simply get no suggestions.
AI review — proofread, claim-grounding, and writing scores#
The AI review panel is a hub of independent review lenses — each runs on its own, in the background, so you can keep working while it thinks. Open it from the editor header: each lens shows a card with its status and when it last ran.
- Open the AI review panel (the lens cards).
- Run any lens on its own — or Full to run them together. A card shows "Reviewing…" with a live X of N sections counter while it works; you can navigate away and a notification arrives when it finishes. On failure you'll see "Couldn't complete the review. Try again."
- Tick "Review the selected passage only" first to scope a run to a highlight.
The lenses:
| Lens | What it shows |
|---|---|
| Proofread | Grammar, punctuation, word choice, formality, passive voice, repetition, and formatting issues, each with a concrete suggestion and a major / minor label |
| Claim confidence | Each substantive claim graded against your cited sources into six categories (misrepresented · contradicted · unsupported · weakly supported · overstated · unverifiable), with an explanation |
| Peer review | A journal-reviewer-style pass plus a scorecard — writing-craft scores (0–10) with one-sentence rationales, weaknesses, strengths, and questions for the authors |
| Source quality | Checks your references against retraction/preprint/rarely-cited signals — runs without spending AI credits |
| Full review | Runs the whole set in one pass — the card you use when you just want everything checked |
| Peer assessment | A structured assessment of the manuscript as a whole, separate from the reviewer-style Peer review pass |
Note: Tone of voice is not one of the review lenses, even though it sits directly beneath them. It is a separate panel with its own Check tone button and does not appear as a card in the review hub — see Tone-of-voice review below. The hub shows six cards: Full review, Proofread, Claim confidence, Peer assessment, Peer review, and Source quality.
Note: The scores are about your writing — how well claims are supported by your citations, how clearly the manuscript is organised, how well it states its contribution. They are explicitly not a judgement of clinical or scientific merit. An empty document is marked reviewed with nothing to flag, rather than spending a review on it.
Review Mode — triage suggestions in the document. After a run, enter Review Mode to walk the suggestions in place: the editor locks while you triage, Y accepts, N rejects, the arrow keys move between suggestions, and Esc exits. Accepting re-verifies the target text is still where the suggestion expects it before applying (so a suggestion that has since moved is flagged, never mis-applied).
Run history & feedback. The panel keeps a history of past runs (with their scores) that you can reopen read-only, and you can download a peer-review report. A 👍 / 👎 on any suggestion opens a short "What was good?" note so you can tell us what helped — the signal is stored, never silent.
Tone-of-voice review#
Beneath AI review, Tone of voice checks how consistently your writing matches a target style and suggests rewordings to move it there — without changing what any sentence means.
- In the Tone of voice panel, pick a target tone from the dropdown.
- Click Check tone.
- You'll see "Checking the tone…", then a match score plus a list of concrete rewrite suggestions. (On failure: "The tone check failed — try again.")
| Tone | Aims for |
|---|---|
| Academic | Precise, hedged, formal scholarly register with disciplined terminology |
| Formal | Professional and polished — no colloquialisms, contractions, or asides |
| Concise | Short, direct sentences with redundancy and filler removed |
| Persuasive | Confident active voice, strong topic sentences, a clear argument |
| Accessible | Plain language a non-specialist can follow without jargon |
Chat with a PDF#
In the PDF reader (open a reference PDF from your library), you can ask questions answered only from that document's text.
- Open a reference that has a PDF attached. (If none is attached, you'll be prompted to attach one from the library.)
- In the question box — "Ask about this PDF…" — type your question.
- Click Ask. The helper text notes: "answers are grounded in its text."
- If the PDF's text doesn't cover your question, the assistant says so plainly rather than guessing. If the PDF has no readable text yet, you'll see "This PDF has no extracted text to search yet."
Answers summarise what the document says, attributed to the document, with the standing reminder to verify against the source.
Read an image (OCR) and analyse figures#
In the notebook, you can attach images to an entry and have the assistant describe them and transcribe any text they contain (OCR).
- In a notebook entry, click Add images / Upload Image and choose your files (PNG, JPEG, GIF, or WEBP; up to 10 MB each).
- Add an optional Caption.
- Click Analyse on the image (Re-analyse to run it again). You'll see "Analysing…"
- The result appears under an ✦ AI read (OCR) label — a concise, factual description with any visible text transcribed verbatim.
Note: Notebook entries are private to you until you share them, and a line at the bottom of the notebook confirms "AI analysis runs in-region." See Privacy below.
Voice transcription#
CoPub can turn speech into text in three places. In each, recording and transcription only appear if the feature is enabled for your workspace (and your browser supports recording).
- Notebook voice notes — record up to 10 minutes; AI transcribes on stop. Use Start recording, then Stop & transcribe. You can also upload an existing audio file, which is transcribed the same way. While it works, the note shows Transcribing.
- Chat voice messages — in a project chat, record a voice message (up to 5 minutes). Use the mic button, then Stop and send (or Cancel recording). The message plays back for teammates and shows (transcribing…) until its Transcript is ready to view.
- Meeting recordings — see Meeting minutes next.
Meeting minutes#
In Meetings, upload a recording and CoPub transcribes it, then drafts structured minutes for you.
- On a meeting, click Upload & transcribe and choose the recording.
- You'll see "Recording uploaded — transcribing…", and the meeting moves through these states:
| Status | Meaning |
|---|---|
| Transcribing… | Converting the recording to text |
| Drafting minutes… | Structuring the transcript into minutes |
| Minutes ready | The draft is available |
| Transcription failed | Something went wrong — try uploading again |
The draft is organised into Agenda, discussion Notes, Decisions made, and Action items — and you can view the full Transcript.
Note: The assistant only fills in blanks and appends action items — it never overwrites minutes you've already written, and it won't invent content the transcript doesn't support. You stay in control of the final minutes, including editing or removing any action item.
Saved prompts#
Saved prompts are your reusable AI instructions — a phrasing you find yourself typing often (e.g. "Rewrite in active voice, past tense"). They cost nothing; they're just stored text.
- Create one from the AI edit panel's Save a prompt (a Name + the Instruction).
- Reuse it as a one-click command wherever custom instructions are accepted.
- Delete one anytime with Delete prompt.
Saved prompts are private to you within your organization — no one else sees or can use yours.
Your monthly AI usage and credits#
AI runs on a monthly credit allowance tied to your organization's plan. To see where you stand, open AI usage (Account → AI usage, at /account/ai-usage). Its intro reads: "Your organization's AI credit balance, this month's spend, and recent activity."
The page shows:
| Tile | Meaning |
|---|---|
| Plan | Your organization's current AI plan |
| Available | Credits you still have this period |
| Used | Credits used this period, and the percentage |
| This month | Total credits spent in the current month |
Below the tiles, a progress bar turns amber as you approach your limit and red once you reach it, and a banner appears:
- At ~80% used — "You've used X% of your AI credits for this period. Consider upgrading before you run out."
- At 100% used — "You've used all your AI credits for this period. New AI requests will be blocked until your plan resets or is upgraded."
A Recent activity table lists your latest AI actions — Feature, Model, Tokens, Credits, and When — so you can see exactly what each request cost. (If you're not in an organization with AI credits, the page says so.)
Tip: Higher plans get larger monthly allowances, more capable models, and faster turnaround on background jobs like AI review. Depending on your plan, running low may mean AI quietly switches to a lighter model rather than stopping — or pauses AI until the month resets. Everything you use is metered here regardless. Your allowance refreshes monthly.
Note: If you ever see "AI quota exceeded for this month" while doing something (for example, analysing an image), that's the same limit — check AI usage to confirm, and ask your administrator about a top-up or upgrade.
Privacy and the writing-assistant boundary#
A few reassurances that hold across every tool above:
- In-region processing. When enabled for your workspace, AI processing runs in-region (within the Kingdom) — the notebook states plainly that "AI analysis runs in-region." Your documents, notes, and library stay within your workspace's trust boundary.
- Web search is opt-in, per question. Search the web is off by default, applies to one chat or deep-research question at a time, and does not stay on for the next one. Only your question is sent — never your identity, your documents, or your project details.
- Finding papers also reaches outside CoPub, and you should know when. Searching the literature — the Cite panel's suggestions, Find papers, and looking a paper up by DOI, ISBN or PMID — queries public research databases (OpenAlex, Crossref, PubMed). These are international services, so those requests leave the Kingdom. Two specifics worth knowing: when the Cite panel looks for a source to support a passage you have written, up to the first 300 characters of that passage are sent as the search query; and every one of these searches is recorded in your workspace's audit trail. Your document as a whole, your library and your project details are never sent. Your administrator can switch literature search off for the workspace, and its cross-border handling is assessed in CoPub's data-transfer documentation.
- Your AI chats are yours. Chat threads about a document are private to you, even on shared documents.
- A writing aid, not a medical device. The assistant is bound to research and writing help. It will decline requests for diagnosis, treatment, dosing, or prognosis, and every answer, review, and summary carries a reminder to verify all facts and citations before you rely on them.
Your Account, Billing & Settings#
This is your control centre for everything about you on CoPub: how your name appears to collaborators, how you sign in, what notifications you get, how much AI you've used, a full download of your own data, and the plan that powers AI in a project. Almost all of it lives behind one menu, and every page works in both English and Arabic (including full right-to-left layout).
Opening your account menu#
Everything below starts from the same place.
- Look at the top-right corner of any screen for your account menu (the options button).
- Click it. A panel opens showing your name and email at the top, then two groups — Profile and Settings — and a red Log out button at the very bottom.
- The Profile group links to: Display name, Email & password, My private data, My Library, Notification preferences, and AI usage. The Settings group holds the Language and Appearance switches.
Tip: The Connected apps page (cloud storage and Zotero) isn't in this menu — you'll usually reach it from the References area of a project when you go to import references, or by visiting
/account/connectionsdirectly.
Your display name#
Click Display name in the account menu. This controls how your name appears to collaborators in projects and comments.
Changing your name
- If you're on the edit form, type your Full name in the box (for example, Jane Smith).
- Click Save name (one-time).
Note: this is a one-time edit. You can change your display name only once from this page. After you save, the page switches to a read-only view showing your Current name. To change it again, you'll need to email support@nomialab.com from your account email with the new name you want — the page shows you this address when the one-time edit is used up.
Tip: Because it's a single edit, double-check the spelling before you save.
A quick security check. If you've been signed in for a while, the page may first ask you to Sign in again before it lets you edit your name. This is a normal protection for sensitive changes — click Sign in again, complete sign-in, and you'll return to the page ready to edit.
About your photo and affiliation: Your profile picture is drawn from your sign-in provider (Google or Microsoft) where one is available; otherwise collaborators see your initials. Your author affiliation (the institution shown next to your name on a manuscript's author list) is set per project in that project's author/members settings, not on this page.
Signing in and security (Email & password)#
Click Email & password in the account menu. This page — titled Account security — is where you manage how you sign in. It has three sections.
Security check first: For any change here, if your session is a little old, you'll see a "Re-authenticate to…" notice with a Sign in again button. Click it, sign in, and you'll come straight back. This keeps someone from changing your security settings at an unattended screen.
1. Your sign-in method#
At any time your account uses one sign-in method — either an email + password, or a third-party provider (Google or Microsoft). The page shows which one is active. Switching an email + password account to Google or Microsoft is not offered, so a password account sees no switch here.
If you currently use Google or Microsoft and want to move to a password:
- The page lists the provider(s) your account signs in with.
- Open Switch to email + password sign-in.
- Enter a New password and Confirm new password.
- Click Switch to email + password.
Your linked providers are removed, third-party sign-in is disabled, and other browser sessions are signed out.
2. Your email address#
This section shows your current email (used for sign-in, password resets, and security notices).
- Enter a New email address and your Current password.
- Click Change email.
- We email a confirmation link to the new address — the change only takes effect once you click that link, and the link expires in 24 hours. We also notify your old address with a cancel link.
While a change is waiting, the page shows a Pending change banner with a Cancel pending change button if you change your mind.
Note: If your account signs in with Google or Microsoft, there's no email to change here — update it at your provider instead.
3. Change password (and "sign out everywhere")#
This section appears only if you sign in with a password.
- Enter your Current password.
- Enter a New password and Confirm new password.
- Click Change password.
Password requirements: at least 12 characters, including a lowercase letter, an uppercase letter, and a digit.
Tip — this is how you "sign out everywhere": Changing your password automatically signs you out of every other browser and device, keeping only the tab you're using. If you've ever left yourself signed in on a shared or lost computer, changing your password is the fastest way to end those sessions. (Changing your email or switching sign-in method does the same thing.)
Connected apps (cloud storage & Zotero)#
The Connected apps page lets you link outside services so you can pull files and references into your projects. CoPub stores an encrypted access token, never your password, and you can disconnect anything here at any time.
Connecting cloud storage. If your workspace has it enabled, you'll see Connect buttons for services such as Google Drive, OneDrive, and Dropbox. Click one and follow the provider's sign-in and permission screens; you'll be returned to this page with the connection listed.
Connecting Zotero (your reference library).
- Go to zotero.org/settings/keys and create an API key.
- On the Zotero card, paste the key into the box.
- Click Connect. The key is checked live with Zotero before it's saved; on success you'll see "Zotero connected as [your username]."
Managing connections. Each linked service is listed with its status. To remove one, click Revoke and confirm.
| Connection status | What it means |
|---|---|
| Active | Working normally |
| Reconnect needed | The link stopped working — connect it again |
| Revoked | You (or we) disconnected it |
Notifications#
CoPub keeps an in-app inbox and can email you, too. Two pages control this.
Your inbox#
Click the bell icon in the header (or open Notifications) to see your inbox, newest first, with unread items highlighted. Each row shows an icon, a short label, a preview snippet, and when it happened.
- Open it: Click a notification to mark it read and jump to the exact project screen that produced it.
- Mark read: Click Mark read on any unread row.
- Mark all read: Use the Mark all read button (top-right, shown when you have unread items).
- Archive: Click Archive to tidy a row out of the list (you'll be asked to confirm).
The inbox updates live — new items appear, and the bell's unread badge updates, without a refresh.
Notification preferences#
Click Notification preferences in the account menu. Every kind of notification is On by default; turn off any you don't want with its On/Off button.
| Notification | You're told when… |
|---|---|
| New reply | Someone replies on a comment thread you started or joined |
| You were mentioned | Someone @-mentions you in a comment |
| Thread resolved | A comment thread you took part in is marked resolved |
| Task assigned | A task is assigned to you |
| Task updated | Someone moves a task you're assigned to |
| Share link viewed | A document share link you created is opened |
| Version restored | Someone restores an earlier version of a document you authored |
| New chat message / New reply in chat | Activity in a project chat you're in |
| You were mentioned in chat | Someone @-mentions you in chat |
| Direct message | Someone sends you a direct message |
Daily email digest. Lower on the same page, toggle Daily email digest on to get a once-a-day email summarising your unread notifications. It's off by default.
Tip: To silence a single conversation without turning off a whole category, use the bell icon next to that comment thread in the project itself.
AI usage#
Click AI usage in the account menu. If your workspace has AI features enabled, this page gives you a read-only picture of your organization's AI credits.
At the top you'll see four figures:
| Figure | Meaning |
|---|---|
| Plan | Your organization's AI plan (Free, Pro, or Team) |
| Available | Credits you can still use |
| Used | Credits used this period, with the percentage |
| This month | Credits spent this month |
A coloured bar shows how much of your allowance is gone. Below it, Recent activity lists individual AI uses with the Feature, Model, Tokens, Credits, and When.
Note: When you cross 80%, a warning suggests upgrading before you run out. At 100%, new AI requests are blocked until the plan resets or is upgraded. If you aren't part of an organization with AI credits yet, the page simply says so.
Downloading your data & your privacy rights#
Click My private data in the account menu to open Your data — a self-service page for your rights under the Saudi Personal Data Protection Law (PDPL). We respond to formal requests within 30 days (with a possible one-time 30-day extension, with notice).
What you'll see first
- Account — your name, email, Public ID, language, and status.
- Activity in CoPub — counts of your project memberships, documents authored, notebook entries, references added, tasks assigned, and audit events.
The actions you can take
- Download all my data now — an instant ZIP file containing everything you've authored across all projects: documents, notes, references, tasks, comments, chat messages, and your audit history. (Your browser saves it as
copub-export.zip.) - Request portable export (official record) — files a tracked, 30-day request. Use this when you need an auditable record of the request itself (for example, for regulator correspondence) rather than just the files.
- Request correction — click it, describe the field, its current value, and what it should be, then Send request. (For anything you can edit yourself, edit it directly instead.)
- Request destruction — anonymises your CoPub account and signs you out. Project content owned by your institution is not affected. You'll be asked to confirm because this can't be undone.
- Withdraw consent — lists any consent-based features you've enabled (such as voice transcription) with a Withdraw button each. If you have none, the page says so.
Your requests. Every request you make is listed with its type, status, the date received, and its due date.
| Request status | Meaning |
|---|---|
| Open | Received and being handled — you can still Cancel it |
| Fulfilled | Completed |
| Cancelled | You cancelled it |
| Refused | Declined (with a reason shown) |
Tip: For the full description of what we process and why, use the privacy notice link at the bottom of the page. Questions can go to privacy@nomialab.com.
Project plans & billing (Pro / Team)#
AI passes are bought per project, and a pass unlocks AI features for everyone in that project. Billing lives inside each project, not in your personal menu.
Getting there: Open the project, go to its Settings, then the Plan & billing tab (/projects/…/settings/billing).
Who can buy or cancel: Anyone in the project can see the plan, but only the project lead can check out or cancel. (This is enforced for real, not just by hiding buttons.)
Your current plan. The card at the top shows either:
- Free — no AI pass; AI features draw on your organization's free allowance; or
- An active pass with its tier, a status badge (active or expiring soon), and its expiry date.
Choosing a plan. If there's no active pass and you're the lead, a Choose a plan section appears with two options, each offered for 1 month or 12 months:
| Plan | What you get |
|---|---|
| Pro | Higher AI credit allowance and priority processing |
| Team | Unlimited feature caps and the largest credit allowance |
Checking out.
- Click the 1 month or 12 months button on the plan you want.
- Depending on how payments are set up for your workspace, one of two things happens:
- You're redirected to the payment provider's secure checkout page to pay, then returned to CoPub; or
- The plan activates immediately (you'll see "Plan activated."), or is recorded as an order awaiting payment confirmation.
Tip: You can click a checkout button confidently — the system is built so a double-click can never charge you twice, and if a checkout fails, nothing is charged.
Cancelling. On an active plan, the lead clicks Cancel plan and confirms. AI features then fall back to the organization's free allowance.
Order history. Every purchase is listed at the bottom with its Order number, Plan, Duration, Status, and Date.
| Order status | Meaning |
|---|---|
| activated | Paid and in effect |
| pending | Awaiting payment confirmation |
| cancelled | Cancelled |
| failed | Payment didn't go through — nothing charged |
Switching to Arabic (right-to-left) and appearance#
Both live in the Settings group of your account menu.
Language. Under Language, click English or العربية. Choosing Arabic reloads the interface in Arabic and flips the entire layout to right-to-left, so menus, text, and controls all read naturally from the right. Your choice is saved to your account and used every time you sign in — switch back the same way at any time.
Appearance. Under Appearance, pick Light, Dark, or Auto (which follows your device's setting). This only changes how CoPub looks to you; it doesn't affect anyone else.
Tip: Language and appearance are personal to your account — changing them never changes what your collaborators see.
The Admin Panel (for workspace administrators)#
Most of this tutorial covers the everyday CoPub app your researchers use. This section is different: it's for the small number of people who administer CoPub for their whole organization. The Admin Panel lives at its own separate web address (not the same as the main CoPub app), it has its own sign-in, and it's where you turn features on for your workspace, manage user accounts, choose the AI plan, and review the history of everything that's been changed.
If you're a researcher just getting started, you can skip this section — your workspace administrator handles all of it for you.
Note: The Admin Panel is a separate application from the main CoPub app. Your admin login here is not the same as a researcher's CoPub login, and your team will give you the panel's web address and your admin credentials directly.
Signing in#
- Open the Admin Panel address your team gave you. You'll land on a simple CoPub Admin sign-in page.
- Enter your Email and Password.
- Click Sign in.
- On success you'll see a short "Welcome back" greeting and land on the Users page, ready to work.
If the email or password is wrong, the page stays put and shows "Invalid email or password." — just try again.
Tip: Every page has a Sign out link in the top-right corner. Click it when you're done; you'll be returned to the sign-in page. If your session expires and you try to open a page, the panel simply asks you to sign in again ("Please sign in to continue.") — nothing is lost.
Finding your way around. A slim navigation bar runs across the top of every page with four destinations:
| Menu item | What it's for |
|---|---|
| Users | View and manage individual people's accounts |
| Organizations | Your workspaces — and the gateway to each one's features, roles, and AI plan |
| Audit | The full, read-only history of admin actions |
| Embeddings | The behind-the-scenes model that powers search (advanced) |
Note: Three important tools — Feature flags, Org roles, and AI plan — aren't in the top bar. They live inside each organization, reached from the Organizations page (see below). That's on purpose: those settings always apply to one specific organization.
Users — viewing and managing people#
The Users page (also your home page after sign-in) lists everyone with a CoPub account so you can find and triage individual people.
Finding a person
- Type into the Search by email or name… box at the top.
- Results filter automatically as you type — there's no button to press.
Each person appears in a row showing their Name, Email, a Status badge, and the available Action buttons. If nobody matches, you'll see "No users found."
Understanding the Status badge
| Status | Badge | What it means |
|---|---|---|
| active | Green | A normal, working account. The person can sign in and use CoPub. |
| deactivated | Grey | The account is switched off. The person can't sign in until it's reactivated. |
Deactivating or reactivating an account
- Find the person's row.
- Click Deactivate (for an active account) or Reactivate (for a deactivated one) on the right.
- A confirmation box appears (for example, "Deactivate name@example.com?"). Confirm to proceed.
- The list refreshes and a brief "User updated." message confirms the change.
Tip: Deactivating is the safe, reversible way to suspend someone's access — for example when a researcher leaves — without deleting anything. You can reactivate them at any time.
Reset the name gate
In the main CoPub app, a person is allowed to set or correct their display name only once. After they've used that one edit, the option locks. If someone made a typo or needs a legitimate name change, you can reopen that one-time edit for them.
- Find the person's row and click Reset name gate on the right.
- A confirmation box explains exactly what will happen: "Reopen the one-shot name-edit gate… (They can change their display name once more.)" Confirm it.
- You'll see "Name gate reset" and the person can now change their display name one more time from their own account.
Note: Resetting the gate doesn't rename the person itself — it simply gives them the ability to make the change once more, from their own profile.
If the panel ever can't reach the main CoPub service, you'll see "Could not reach the CoPub API." at the top of the page — that's a connection issue, not something you did wrong; wait a moment and reload.
Organizations — your workspaces#
The Organizations page lists the workspaces (organizations) on your CoPub. Use the Search by name… box the same way as on the Users page — results filter as you type. If none match, you'll see "No organizations found."
Each organization row shows its Name, Type, and Status, followed by three Manage links on the right. These links are the doorway to everything you can configure for that one organization:
| Manage link | Takes you to |
|---|---|
| Feature flags | Turn features on or off for this workspace |
| Org roles | Grant or revoke administrative roles to that workspace's people |
| AI plan | Choose the AI plan tier and top up AI credits |
Each of the three is covered in its own part below. On any of those pages, a ← Organizations link at the top-left brings you back to this list.
Feature flags — turning features on or off for a workspace#
This is how features get switched on for a workspace. From an organization's Feature flags page you decide, feature by feature, what's available to everyone in that workspace.
The page shows the organization's name and a table with one row per feature. Each row has:
| Column | What it tells you |
|---|---|
| Flag | The feature's name and a short description of what it does |
| Default | Whether the feature is normally on or off across CoPub when you haven't made a specific choice |
| Override | Your specific choice for this workspace — or a dash (—) if you haven't set one |
| Effective | What's actually in force right now: an on (green) or off (grey) badge |
Turning a feature on or off
- Find the feature's row.
- Click Enable to switch it on, or Disable to switch it off, for this workspace.
- The table refreshes and confirms with a short "Updated…" message.
Once you've made a choice, the Effective badge reflects it immediately, and a Clear button appears in that row.
Clearing your choice
- Click Clear in the feature's row (it only shows when you've set a choice).
- Your workspace-specific setting is removed and the feature returns to its Default behavior. You'll see "Cleared override…".
Tip: Think of it as three states. Default is CoPub's built-in behavior; Enable/Disable is you overriding that just for this workspace; Clear removes your override and lets the default take over again. The Effective badge always shows the true, current answer — read it if you're ever unsure.
Note: Elsewhere in this tutorial you'll see phrases like "if this is enabled for your workspace." This page is exactly where that's decided — and since every flag now defaults to on, a missing feature means someone set an explicit Disable override here, not that it was never switched on. If a researcher reports a feature missing, read its Effective badge first.
⚠ A green Effective badge does not mean the feature works. Flags control visibility; the AI features additionally need the workspace's AI service credentials. A flag showing Effective: on while every AI call fails means the credentials are missing — check with whoever operates the deployment before telling the researcher it is fixed. This is the single most common wasted round-trip between a researcher and an administrator.
Org roles — who administers a workspace#
From an organization's Org roles page you grant people administrative roles within that workspace. The table lists the workspace's members and anyone already holding a role, showing each person's Name, their unique user ID, their Email, and their Current roles.
The five roles
| Role | What it designates |
|---|---|
| org_admin | The workspace's top administrator. Carries the ability to administer the organization's departments and its own single sign-on / identity provider settings. |
| department_head | Head of a department within the workspace. |
| research_director | Research director role for the workspace. |
| it_admin | IT administrator role for the workspace. |
| compliance_officer | Compliance officer role for the workspace. |
Note: org_admin is the powerful one — grant it sparingly, and only to people who should administer the whole workspace's structure and login setup.
Granting a role to someone already listed
- Find the person's row.
- In the Grant a role dropdown on the right, choose a role.
- Click Grant. A "Granted…" confirmation appears and the role shows up as a small chip in their Current roles.
Removing a role
- In the person's Current roles, each role appears as a chip with a small ×.
- Click the × next to the role you want to remove.
- Confirm the "Revoke…?" prompt. The chip disappears and a "Revoked…" message confirms it.
Granting a role to someone not in the list yet
Sometimes you need to appoint an administrator who isn't a member of any project in the workspace yet (for example, seeding the very first org_admin). Use the form at the bottom of the page:
- In the User public ID field, paste the person's unique user ID (you can copy it from their row on the Users page, or from an existing row here).
- Choose a role from the dropdown.
- Click Grant.
Tip: If a grant doesn't go through, the message tells you why: the person already has that role here, or no user with that public ID exists (double-check the ID you pasted). If the workspace has no members or role-holders yet, the page simply says so.
AI plan — choosing an organization's plan and topping up credits#
From an organization's AI plan page you set which AI plan tier the workspace is on and manage its AI credits (the budget that AI features draw from). The page opens with four at-a-glance tiles:
| Tile | What it shows |
|---|---|
| Plan | The workspace's current plan tier |
| Available | Credits remaining to spend on AI features |
| Used | Credits used so far, with a percentage |
| This period | Spend in the current billing period |
The plan tiers
Every AI feature is available on every tier — higher tiers simply give a larger credit allowance, access to stronger AI models, higher per-feature limits, and faster priority when the system is busy. The tiers currently offered are:
| Tier | In short |
|---|---|
| free | Entry tier — a modest credit allowance and the standard models. |
| pro | Standard paid tier — a much larger allowance, an additional higher-quality model, and higher limits. |
| team | Top tier — the largest allowance, access to the strongest models, and top queue priority. |
Note: The dropdown always shows whatever tiers are available on your CoPub, and the four tiles above show that workspace's live numbers.
Switching the plan
- In the Switch plan dropdown, choose the tier you want.
- Click Set plan. A "Switched to…" message confirms it and the tiles update.
Tip: Setting a plan resets the workspace's credits to that plan's allowance — the page tells you this right next to the button. So switching is also how you reset the credit balance to a fresh, full allotment for the new tier.
Topping up credits
If a workspace runs low before its plan resets, you can add credits directly:
- In the Top up credits field, type a whole number (at least 1) — for example, 1000.
- Click Add credits. You'll see "Added … credits." and the Available tile goes up.
Note: Top-ups must be a positive whole number. If you leave it blank or enter something invalid, the panel declines with a short "positive integer required" reminder — nothing is charged.
Audit — the read-only history of admin actions#
The Audit page is CoPub's permanent, append-only history: a record of administrative actions that can be added to but never edited or erased. It's your accountability trail — who changed what, and when.
Each entry is shown in a table:
| Column | What it shows |
|---|---|
| When | The date and time the action happened |
| Action | What kind of action it was (for example, a feature-flag change) |
| Actor | Who did it (or a dash if not applicable) |
| Resource | What it acted on (or a dash) |
| Metadata | Extra details about the action |
Filtering the history
- Type into the Filter by action type box (it even suggests an example, like a feature-flag-set action).
- The list narrows automatically as you type. Clear the box to see everything again.
If nothing matches, you'll see "No audit events."
Tip: After making a change elsewhere in the panel — say, enabling a feature or switching a plan — you can come here and filter to confirm it was recorded. This history is a helpful reference when reviewing changes with your team or for compliance.
Embedding model — the engine behind search (advanced)#
The Embeddings page is an advanced setting most administrators never need to touch. It chooses the local model that powers CoPub's semantic search — the technology that lets people find documents by meaning, not just exact keywords. The default is already a sensible choice, and changing it is a deliberate, occasional action.
The page lists the available models in a table:
| Column | What it shows |
|---|---|
| Model | The model's friendly name and its technical identifier |
| Dims | A technical measure of the model's detail |
| Multilingual | yes means it understands multiple languages (including Arabic); a dash means English-only |
| Footprint | Roughly how much memory it needs and how fast it is (from fast, lightweight options up to heavier, higher-quality ones) |
| Status | Whether this model is currently active, newly selected (waiting to take effect), or offers a Select button |
Tip: Because CoPub is bilingual (English and full Arabic), if your workspace works with Arabic content, choose one of the models marked Multilingual: yes so search understands Arabic as well as English.
Selecting a different model
- Find the model you want and click Select in its row.
- You'll see a confirmation reminding you of the two remaining steps: restart CoPub, then re-embed.
- The model you picked now shows a selected badge (amber), while the one still running keeps the active badge (green).
Note: A model change does not take effect immediately. A prominent amber banner appears explaining that your selection is pending until CoPub is restarted. Restarting CoPub is a technical step your team handles — coordinate with them before changing this.
Re-embedding the library
After a restart with a new model, CoPub needs to re-process existing documents so search works correctly with the new model.
- Click Re-embed entire corpus near the top of the page.
- You'll see a confirmation that the re-processing has been queued (with a count of items). It runs in the background.
Tip: The safe order is always: Select the model → have your team restart CoPub → click Re-embed entire corpus. Skipping the re-embed after a model change can make search results unreliable until it's done. If you're unsure, leave this page on its default and ask your team before changing it.
Getting help#
- In-app: the Options menu (top-right cog) and each section's on-screen hints guide you as you work.
- Academic terminology: not sure what a term means? The Academic terminology page (linked in the site footer, at /help/terminology) gives quick definitions for common academic-writing, citation, and publishing terms — from IMRaD and DOI to impact factor and RAG.
- Support: email support@nomialab.com for account, verification, or billing help.
- Your administrator: for features that need enabling for your workspace, or for user, role, and plan questions, contact your organisation's administrator (see The Admin Panel).
CoPub is a research and writing assistant. Its AI features help you write, organise, and reason about your work — they do not provide medical or clinical decision-making advice.
Feature reference#
Every feature, with what it is for, what has to be true before it works, and exactly how to start it.
Getting in#
Creating an account with an email address#
A CoPub account is made with an email address and a password — the form headed Create your account. Signing up with a Google or Microsoft account is not offered.
Why you would use it. Someone has invited you to a project, or you want a workspace of your own, and you would rather your access did not depend on an institutional account you might one day lose.
Before you start#
- Where you need to be: the page headed Create your account, at
/users/register. ⚠ Nothing in the product currently links to it. The sign-in page has a Create account link, but it is hidden while access is invite-only, and every call to action on the marketing site points at Sign in instead. Type the address in yourself. - If you were invited to a project, the email's directions are wrong. It
tells a reader without an account that "the link takes you to sign-up". It
does not: Accept the invitation opens
/invitations/…, which requires a signed-in account, so it bounces you to the sign-in page — where the Create account link is the one that is hidden. Type/users/registeryourself and register with the address the invitation was sent to (capitalisation does not matter). Nothing else is needed after that: every successful sign-in claims any live invitation addressed to your email, so the membership appears once you have verified and signed in, whether or not you go back to the link. - Role: none, and you do not have one yet. Roles are per project and are
given to you when someone invites you — see
collaboration/project-roles.md. - Switched on: always. Registration sits behind no feature flag, so this is not something an administrator can switch off for your workspace.
- Also needed: an email address you can open within 24 hours, and a password of 12 to 128 characters containing a lowercase letter, an uppercase letter and a digit.
- Costs: nothing.
How to use it#
- Open Create your account. Under the heading, "Sign up with your email and password." introduces the form — there is no Google or Microsoft option.
- Fill in Email. Full name (optional) can be left blank — but note
that changing your name later is restricted, so it is worth filling in now
(
account/display-name.md). - Fill in Password. The hint under the field states most of the rule: Min 12 chars; must include a lowercase letter, an uppercase letter, and a digit. It leaves out the ceiling — a passphrase longer than 128 characters is rejected too, with should be at most 128 character(s). The form checks as you type, so a rejected password is visible before you submit.
- Press Sign up. It reads Creating account… while it works.
- You land on the sign-in page with the message Check your inbox to verify your email — we've sent a one-time confirmation link. You cannot sign in yet: an unverified account is refused at the sign-in form, so there is nothing you can do in CoPub until you have clicked the link.
- Open the email — its subject is Verify your CoPub email address — and click Verify my email. The link is good for 24 hours from the moment it was issued, and it works exactly once.
What you should see. The link returns you to the sign-in page with Email verified. You can sign in now. Verifying does not sign you in; enter your email and password to do that. If you arrived from a project invitation, signing in returns you to the invitation you started from.
When it doesn't work#
| What you see | What it means | What to do |
|---|---|---|
| is already registered under the Email field | An account already exists on that address. The form does not say whether it is a password account or a Google / Microsoft one, and signing up again will not attach a password to an existing account | Sign in instead. If it is a password account you have forgotten, use Forgot password? (getting-in/password-reset.md) |
| The account is created, the confirmation message appears, and no email ever arrives | The confirmation message is shown when your account row is written, not when the mail leaves. The message is handed to a background queue and its outcome is never reported back to the screen — so if the server has no mail provider configured, or the provider rejects the message, nothing about that surfaces anywhere in the interface | Wait a few minutes and check your spam folder. Then use Send verification email once (below). If it still does not arrive, write to support@nomialab.com — support can mark an address verified without a link, though there is no button for it in the admin panel, so it is a request rather than a self-service fix |
| That verification link is invalid or has expired. You can request a fresh link by trying to sign in. | Any of four things: more than 24 hours have passed; you have already used that link once; you requested a fresh link, which deletes the earlier one; or the address that reached the server was not the whole link — a mail client that wraps or shortens long URLs produces exactly this message, and so does a hand-typed one | Try to sign in, then use Send verification email on the amber panel |
| Your email isn't verified yet. Request a fresh verification link below. | Your password was correct but the address is still unverified | The same sign-in page now shows an amber Verify your email to sign in panel with a Send verification email button. That panel is the only place the resend lives — there is none on the sign-up page |
| You've reached the verification email limit (5 per 24 hours). Please contact support@nomialab.com for help. | Five verification emails have been sent for that address in the current window | The allowance is counted per UTC calendar day rather than as a rolling 24 hours, so it resets at midnight UTC. If you cannot wait, contact support@nomialab.com |
| A bare Too Many Requests page after pressing Sign up | More than five registrations were submitted from your network address inside a minute. Shared university networks make this easier to hit than it sounds | Wait a minute and submit again |
| Sign-in rejects the password on an address you know you created with Google or Microsoft | That account has no password at all, so there is nothing for the form to match | Google and Microsoft sign-in are not offered, so contact support@nomialab.com |
Good to know#
- A new link cancels the old one. Requesting a fresh verification email deletes any earlier pending link for that address, so an old message in your inbox stops working the moment you press Send verification email. Always click the newest one.
- Your address is not case-sensitive.
[email protected]and[email protected]are the same account — you cannot register both, and either spelling signs you in. - An account is on the password side or the SSO side, never both. CoPub
never links the two by matching addresses: signing up with a password on an
address that already has an account is refused, and signing in with Google or
Microsoft on an address that already has a password is refused too, with
This email is registered with a password. Please sign in with your email and
password. Moving from one to the other is a deliberate switch made from
Account security while already signed in, and it revokes your other sessions
(
account/account-security.md). - The privacy line below the button is a disclosure, not a checkbox. It sits under Sign up, not above it, and there is nothing to tick; creating the account is the act of agreement, and the linked Privacy Notice is readable before you register.
Related#
getting-in/signing-in.md— the sign-in form and the amber unverified panelgetting-in/email-verification.md— what consuming the link actually doesgetting-in/password-reset.md— and why its reply is the same either waygetting-in/sso-google-microsoft.md— the Google / Microsoft path (not offered:config :nomia, :sso_offeredships false, B-AUTH-HIDE-SSO-BUTTONS-ON-SIGN-IN-PAGE-001)getting-in/accepting-a-project-invitation.md— arriving here from an invitation
Signing in#
The email-and-password form at /users/log_in, headed Sign in. It is reached
from Already have access? Login — in the landing page's header on a desktop
screen, and from the same words under the hero buttons on a narrow one, where the
header link is hidden — and it is where almost every other route in CoPub sends
you when it needs to know who you are.
Why you would use it. It is the only way in. Signing in with a Google or
Microsoft account is not offered: the page shows no provider buttons, and its
subtitle reads "Use your email and password." A provider address typed by
hand, such as /auth/google, answers "Unknown sign-in provider" and brings
you back here. An institutional or work account cannot be used either, even if
your organization has one configured.
Before you start#
- Where you need to be: the sign-in page — Already have access? Login in
the landing header (or, on a phone, the Login link under the hero), or
/users/log_indirectly. It is public, and it stays reachable even while you are already signed in. - Role: none. Project roles decide what you can do once you are inside; they have no bearing on whether you may sign in.
- Switched on: always available. Nothing on this page is behind a feature flag, so there is nothing for an administrator to switch off and nothing to ask them for.
- Also needed: an account that already exists, with its email verified.
There is no Create account link on this page — it is hidden during early
access — but registration itself is not closed:
/users/registerstill works if you type the address in yourself. Seegetting-in/signing-up.md. - Costs: nothing.
How to use it#
- Type your address into Email. Capitalisation does not matter:
[email protected]and[email protected]are treated as the same account. - Type your Password.
- Press Sign in.
What you should see. You land on your dashboard.
CoPub returns you to the page you were turned away from only sometimes, and it is
worth knowing which times. An invitation link (/invitations/…) and a
share-link claim (/d/…/claim) are remembered: you sign in and arrive at the
thing the link was for. A link straight into a project or a document is
not. Those screens are live views, and the bounce that lands you here — which
greets you with "Please sign in to continue." — does not record where you were,
so you end up on the dashboard and have to follow the original link a second
time.
How long you stay signed in#
Seven days, from the moment you sign in — and using CoPub does not extend it. The session is a token stored on the server with a fixed seven-day expiry, and nothing refreshes that expiry when you make a request. A researcher writing every day is asked for a password on the eighth day exactly like one who left the tab untouched.
Two smaller facts follow from how the cookie is set. It carries no expiry date of its own, so quitting your browser normally discards it and you sign in again on the next launch; seven days is a ceiling, not a promise. And signing in somewhere else does not sign you out here — each sign-in mints its own token and leaves existing ones alone.
Three things do end every session at once, on every device: a password reset, a password change made from Account security, and an administrator banning the account. In each case the session tokens are deleted inside the same operation that writes the new password or the new status. Changing your own password re-issues the cookie for the browser you did it in, so in practice it signs out your other devices, not that one.
If your email is not verified#
If the address and password are both correct but the address has never been verified, you are returned to the sign-in page with "Your email isn't verified yet. Request a fresh verification link below." and an amber panel appears between the Sign in heading and the email form, headed Verify your email to sign in and naming the address in question. The panel holds one button, Send verification email, above the note "Limit: 5 verification emails per 24 hours. After that, please contact support@nomialab.com." Everything else on the page still renders — the form and Forgot password? — it just will not let you in until the address is verified.
Pressing it sends a fresh link, good for 24 hours, and tells you so. Two consequences are worth knowing before you press it twice. Requesting a new link kills the old ones — the previous verification links are deleted before the new one is minted, so the most recent email in your inbox is the only one that will work. And the five-per-24-hours limit is counted per address, not per browser, so it follows you across devices; past it, the page tells you to contact support@nomialab.com.
The panel is driven by a marker left in your browsing session, not by a live check, which makes it sticky. It keeps appearing on the sign-in page — still naming the earlier address — through further failed attempts, and, more confusingly, it is still there after you click the verification link: that link returns you to this page with "Email verified. You can sign in now." sitting directly above an amber panel still telling you to verify. Ignore the panel at that point and sign in; the successful sign-in is what clears it. The only other thing that clears it is a resend that finds nothing pending.
Why a wrong address and a wrong password give the same answer#
Type an address that has no account and you get "Invalid email or password." Type a real address with the wrong password and you get "Invalid email or password." — the same words, the same page, the same amount of information. This is deliberate, and it is defended even in the timing: when no account matches, CoPub still runs a password verification against a dummy value so that the "no such account" answer does not come back measurably faster than the "wrong password" one.
The reason is that the alternative is a membership oracle. A form that distinguishes the two lets anyone feed it a list of institutional addresses and learn which colleagues have accounts on this platform. The cost of closing that is the frustration you may be feeling: you cannot use this form to work out which of your addresses you registered with.
One consequence is easy to misread. Account status is disclosed — a suspended, deactivated or banned account gets its own specific message — but only to someone who has already typed the correct password. Status is never revealed to a guesser, only to the account's owner.
The email field is refilled with what you typed so you only have to retype the password; that address travels in the page's web address to get there, so it will appear in your browser history.
Signing out#
Open the Account menu — the small square with your initials at the top right of every signed-in screen — and choose Log out, the last entry, in red. You land back on the public landing page.
This is a real sign-out, not just a cleared cookie: the session token is deleted on the server, so a copy of the cookie taken from that machine is worthless afterwards. One caveat, and it is the same one that applies to password resets: a CoPub tab that is already open and still connected keeps working until it reloads or its connection drops, because nothing interrupts a live connection. On a shared or public machine, close the browser rather than trusting that the other tab has noticed.
When it doesn't work#
| What you see | What it means | What to do |
|---|---|---|
| Invalid email or password., with your address still filled in | Either no account uses that address or the password is wrong — the message is identical for both, on purpose | Retype the password. Capitalisation of the address is not the problem; it is matched case-insensitively |
| Your address and password are both right — you are certain — and you are still bounced, with "For your security, sign in again with your current account to continue." | You are already signed in as somebody else in this browser. Signing in as a second person is refused outright, so that a valid password cannot silently swap the session to another identity | Log out first, then sign in. There is no supported way to hold two accounts open in one browser |
| An amber Verify your email to sign in panel | Address and password are right; the address has never been verified | Press Send verification email and use the link within 24 hours |
| You clicked the verification link, were told "Email verified", and the amber panel is still on the sign-in page | The panel is a leftover marker in your browsing session, not a live check — it does not notice the verification | Ignore it and sign in normally; signing in clears it |
| You pressed Send verification email, the page says it was sent, and nothing arrives | The confirmation is written when the message is handed to the mail system, not when it is delivered — a delivery failure produces exactly the same wording | Check spam, wait a few minutes, then try once more. Past five tries in 24 hours, contact support@nomialab.com |
| The amber panel disappeared and you got "If a pending verification exists for that email, we've sent a fresh link" | Nothing was pending for that address — it is already verified, or it signs in through a provider instead | Try signing in again; if it is verified, it will now work |
| A bare, unstyled page reading Too Many Requests | More than eight sign-in attempts in a minute. The count is per network address, so a shared campus or hospital connection can trip it on someone else's typing | Wait a minute. Nothing is wrong with your account — repeated wrong passwords do not lock it |
| This account is suspended. or This account has been deactivated. | The password was correct; the account is not in an active state. Both are set by an administrator | Contact team@copub.app. Resetting the password will not change it — the standing of the account is checked separately from the password |
| This account has been banned. Contact team@copub.app to appeal., and you land on an appeal page | A terminal state — either an administrator banned the account outright, or it crossed the platform's strike threshold | Appeal at the address given; the page you land on is public and explains the route |
| You were signed in yesterday and are asked again today, having changed nothing | Either the seven-day token expired, or your browser discarded the session cookie when it closed | Sign in again. This is normal |
| The sign-in page appears when you click a link somebody sent you, with "Please sign in to continue." | Expected — the link needed a signed-in user | Sign in. An invitation link or a share-link claim takes you on to what it was for; a link to a project or a document does not — you land on the dashboard, so open the link again once you are in |
Good to know#
Repeated wrong passwords do not lock your account. CoPub carries a per-account lockout, but it ships switched off — failures are counted and nothing is ever locked. The only throttle you can meet on this page is the per-network one of eight attempts a minute. This is a deliberate trade: the way out of a lock would be a password-reset email, and locking people out of a system that might not be able to email them is worse than the brute-force exposure it closes.
Signing in claims the project invitations waiting for your address — with one
condition. If a colleague invited you before you had an account, the invitation
is attached to you at your first successful sign-in rather than needing a second
click, and that case always works: an account that belongs to no organization yet
can claim anything pending for it. Once you do belong to an organization, signing in
claims only invitations to projects of an organization you already belong to. One from
outside it is never claimed at sign-in: it waits until you click the
Accept the invitation button in the email while signed in with the invited
address, then Accept on the page it opens; you then join that one project as
an External member. Details in
getting-in/accepting-a-project-invitation.md.
This paragraph previously said an invitation from outside your organization could not be accepted at all ("That invitation isn't valid anymore.") and that somebody on the project had to add you directly. Accepting it now joins you to that project as an External member.
The step-up window is five minutes. Sensitive account-security actions ask you to re-enter your password, and the resulting freshness lasts five minutes — so returning to those settings later means proving yourself again.
Related#
getting-in/signing-up.md— making the account in the first place, and why nothing links to that pagegetting-in/email-verification.md— consuming the link the amber panel sendsgetting-in/password-reset.md— the way back in when the password is the problemgetting-in/sso-google-microsoft.md— Google / Microsoft sign-in, which is not offered (config :nomia, :sso_offeredships false, B-AUTH-HIDE-SSO-BUTTONS-ON-SIGN-IN-PAGE-001)getting-in/account-suspended-or-banned.md— when the password is fine and the account is notaccount/account-security.md— changing a password you still know, and the five-minute re-auth
Resetting a forgotten password#
The Forgot password? route: you give CoPub your email address, CoPub emails you a link, and the link lets you choose a new password. The link is good for ten minutes and works once.
Why you would use it. You are locked out of your own manuscripts and there is nobody to ask — this is the only self-service way back in. It is also the right route after you suspect someone else has seen your password, because setting a new one signs out every browser session on your account, everywhere.
Before you start#
- Where you need to be: the sign-in page. Under the email and password
fields there is a Forgot password? link; it opens a page headed Forgot
password? at
/users/forgot_password. You can also go straight to that address — it is public and needs no sign-in. - Role: none. Project roles have no bearing here; you are not in a project yet.
- Switched on: always available. These two pages are not behind a feature flag, so there is nothing an administrator can switch off and nothing to ask them for.
- Also needed: an account that signs in with a password. An account that signs in through Google or Microsoft has no password stored, and this route will silently do nothing for it — see the table below.
- Costs: nothing.
How to use it#
- On the sign-in page, click Forgot password?.
- Type your address into Email and press Send reset link. The button gives you no busy state — it looks unpressed until the next page arrives. Resist pressing it a second time: each press spends one of the three requests a minute you are allowed.
- You are returned to the sign-in page with the message "If an account exists for that email, we've sent a password-reset link. The link expires in 10 minutes." You get this message whatever you typed — see below for why.
- Open the email titled Reset your CoPub password and press Reset my password in it. Do this within ten minutes of asking.
- The link opens Reset your password. Type into New password: at least 12 characters, including a lowercase letter, an uppercase letter and a digit (the page states this under the field, and complains as you type if you are short). Press Reset password.
- You are returned to the sign-in page with "Password reset. You can sign in with your new password." You are not signed in automatically — sign in with the password you just chose.
What you should see. Two identical-looking returns to the sign-in page, each with a message across the top: first the "if an account exists" notice, then, after the link, the confirmation. Anything else on the second step — in particular the red "That reset link is invalid or has expired" — means the link, not the password, was the problem.
Why the answer is the same either way#
CoPub does not tell you whether the address you typed is registered. Whether the address belongs to an account, belongs to a Google-only account, or belongs to nobody at all, you get the same wording, on the same page, with the same amount of information. The code that sends the email is deliberately written not to branch on the answer.
This is not evasiveness. A forgot-password form that says "no such account" is a membership oracle: anyone can feed it a list of addresses and learn which colleagues have accounts here — who is running research on this platform, and with which institutional address. The cost of closing that is exactly the annoyance you are feeling: you cannot use this form to check whether you registered with your university address or your personal one. Try the reset on both; the one that is registered is the one that produces an email.
When it doesn't work#
| What you see | What it means | What to do |
|---|---|---|
| The confirmation appeared, but no email arrives | Three possibilities, and the message is identical for all three by design. The mail is still in flight or in your junk folder — CoPub hands it to a background sending queue rather than sending it during your request, so it is not instant. Or no account uses that address. Or the account signs in through Google or Microsoft and has no password to reset, in which case there was nothing to send | Check junk mail and give it a minute, then try your other addresses. If the account signs in with a provider, this route can never help — use the provider instead |
| A bare Too Many Requests page, unstyled | More than three reset requests in a minute from your network. The limit counts by network address, so a shared campus connection can trip it without you | Wait a minute and try once more |
| "That reset link is invalid or has expired. Request a fresh one below." | The link is over ten minutes old, has already been used once, or was broken across lines by your mail client | Request a fresh link and use it promptly. Click the button in the email rather than copying the address by hand |
| The reset form opens and accepts your typing, then rejects it as expired | The link is not checked until you submit — the form is drawn from the address, not from a live check. So a dead link still looks perfectly healthy until the moment you press Reset password | Nothing is wrong with your password. Request a fresh link |
| The password is refused with a message under the field | Under 12 characters, over 128, or missing a lowercase letter, an uppercase letter or a digit | Lengthen it. A short passphrase of a few words with a capital and a digit satisfies all four rules |
| The reset succeeded, but signing in says your email isn't verified | Resetting a password does not verify an address. These are separate steps | Use Send verification email. It is not on the sign-in page by default — the refusal you just got is what puts the amber Verify your email to sign in panel there, and the button is inside it |
| The reset succeeded, but signing in says the account is suspended, deactivated, or sends you to an appeal page | Resetting a password does not change an account's standing, and the reset route does not check it — so a blocked account can set a new password and still be blocked | The message tells you which; a banned account has an appeal address on the page it sends you to |
Good to know#
Ten minutes really is ten minutes, timed from when you asked, not from when you opened the mail. If the message is slow to arrive you may already be too late. Asking again costs nothing.
Asking twice does not cancel the first link. Every link you request stays usable for its own ten minutes, and using one does not disturb the others. If you pressed the button three times, three live links are sitting in your inbox. Only the one you click is spent; delete the rest.
Choosing a new password signs you out everywhere. The reset page understates it — the wording on screen is "You'll be signed out from any other devices" — but every browser session on the account is deleted in the same operation that stores the new password, including the one on the device you are sitting at. There is no "other" about it. One exception is worth knowing: a CoPub tab that is already open and still connected keeps working until you reload it, follow a link that loads a fresh page, or the connection drops, because nothing interrupts a live connection. Reload that tab if you want it out.
Nothing else about your account changes. Your name, projects, workspace membership and documents are untouched; only your password and your browser sessions are affected.
An account that signs in with Google or Microsoft cannot be given a password this way — the reset route skips it entirely, so no email is sent. The only way to move such an account onto a password is from inside it: sign in with the provider, then use Switch to email + password sign-in in account security. Note also that Google and Microsoft sign-in are not offered, so if your account is provider-only and you are locked out, neither route is open to you and you will need to contact support.
Related#
getting-in/signing-in.md— the page you return to, and what each refusal meansgetting-in/email-verification.md— the separate step a reset does not performgetting-in/sso-google-microsoft.md— accounts that have no password at allaccount/account-security.md— changing a password you still know, and switching sign-in methodgetting-in/account-suspended-or-banned.md— when the password is fine and the account is not
Home & workspace#
The dashboard — your list of research projects#
The screen you land on after signing in, and the one the Projects navigation item always brings you back to. It is a heading with two buttons beside it, a band of counts, a search box, a status filter, and one ruled row per project. The heading reads Research Projects.
Why you would use it. It is the way back into work: find the manuscript you were drafting last week, see how many of your studies are still in progress against how many are already published, and start a new one. Every other screen in CoPub — the editor, the references, the lab notebook — is reached from a row on this list.
Before you start#
- Where you need to be:
/dashboard. Signing in lands you here, and so does Projects in the top bar (or the Projects tab at the bottom of the screen on a phone). - Role: any. The dashboard needs no project role, and neither does creating a
project — you become the new project's Principal Investigator automatically.
(One limit sits on creation, not on this screen: an account may auto-create at
most three workspaces. See
workspace/creating-a-project.md.) - Switched on: always available. Unlike most of CoPub, this screen sits behind no feature flag at all, so there is nothing an administrator can switch off here.
- Also needed: nothing.
- Costs: nothing.
What is on the screen#
Two buttons beside the heading. New project, always. And to its left Administer organization, which appears only if you hold the Organization admin role somewhere; it leaves the dashboard for that organization's departments page.
Six figures, in one ruled band below them — one for each button in the filter row further down, in the same order. The pairing is positional only: the first figure, Total Projects, does not count the same set as the All filter that sits opposite it.
| Tile | What it counts |
|---|---|
| Total Projects | every project the list is scoped to — including archived ones |
| In Progress | the status a new project starts in |
| Under Review | |
| Completed | |
| Published | |
| Archived |
A seventh cell closes the band and holds no figure — two green lines of small type that behave differently. New here? Learn CoPub in 5 short tutorials → is a link and leaves the screen. Request to join an organization → is not a link: it opens a short form in place, directly under the band — Organization code, Role, Reason (optional), Send request — and an organization admin decides on what you send.
Each project row carries the title (click it to open the project), the project's one-line description if it has one, the status as a tag, a small square showing the initial of whoever created the project, the date it was last Updated, and three shortcuts — Editor, Notes, Refs — that jump straight into that part of the project without going through its overview page. Rows are ordered by that Updated date, newest first.
The row shows no more than that. Your role on the project, its reference count and its open task count are all absent by design — the list does not load them.
⚠ Three things the screen does not say out loud#
1. "All" hides archived projects, but Total Projects counts them. The All filter is not "everything" — it is "everything except archived". Only the Archived button shows archived work, and it shows nothing else. Total Projects, however, is the sum of all five statuses, archived included. So a workspace with three live projects and two archived ones reads 5 in the tile and lists 3 rows underneath it. Nothing is broken; the two numbers are measuring different sets. The tiles are fixed in a second sense too: they are counted once, when the page loads, and never narrow to match what you are looking at — clicking Published changes the rows and leaves all six figures alone.
2. "Updated" is not "last worked on". That date moves when the project record changes — when it is created, when its status changes, when its journal template or citation style is set. Writing in the editor, adding a reference or filing a notebook entry does not touch it. A project you wrote in this morning can sit at the bottom of the list under a date from three months ago, because the list is sorted by the same field.
3. The subtitle is an approximation in both directions. The small grey line above the heading — not under it — reads "All projects you're a member of, across all your organizations." Neither half is exactly right. It is not across all your organizations once you have picked a workspace — from then on the list and every tile show that workspace only. And it is more than the projects you are a member of: within a workspace the list is every project belonging to that organization, including ones nobody ever added you to. In a personal workspace that distinction is invisible, because you are the only person in it. In an institutional one it means colleagues can see your project titles and descriptions on their own dashboards.
How to use it#
- Search — type into Search projects.... It filters a fifth of a second after you stop typing, and matches titles only — never descriptions, never document text. There is nothing to submit. It re-runs on key-up and only on key-up, so backspacing the box empty restores the full list — but the small ✕ some browsers draw inside a search box does not: it clears the text and leaves the list filtered on what you typed.
- Filter — the buttons beside the search box: All, In Progress, Under Review, Completed, Published, Archived. Exactly one is active at a time, and it combines with whatever is in the search box.
- Open a project — click its title, or go straight to a part of it with Editor, Notes or Refs.
- Start a project — New project, at the top right, which opens a three-step wizard rather than creating anything immediately: your prompt and target journal, then citation settings, then how headings should be generated. Nothing exists until you press Start Writing, press Skip and start writing, or drop a Word file in.
- Change what the list covers — open the account menu, top right, and pick a workspace under Workspace, or All workspaces to lift the restriction.
What you should see. A row for each project in the current workspace, newest Updated date first. The six tiles do not follow the list: they always describe the whole workspace, so under a filter they are meant not to match the rows. With no projects at all you get No projects yet and a New project button; with a search or filter that matches nothing you get No projects match this filter instead, and the button is not offered.
When it doesn't work#
| What you see | What it means | What to do |
|---|---|---|
| Nothing is switched off, you know you have projects, but the list is empty and every tile reads 0 | You are in a workspace that has no projects in it. The dashboard is partitioned by the workspace you last chose, and it stays chosen until you change it | Account menu → Workspace → All workspaces. See workspace/switching-workspace.md |
| …and there is no Workspace section in the account menu | The switcher is only rendered for people who belong to more than one organization | Nothing to switch. If you expected a second organization, you are not a member of it yet — see workspace/requesting-to-join-an-organization.md |
| Total Projects is larger than the number of rows | The tile counts archived projects; All does not list them | Click Archived to see the difference |
| A project you know exists is missing from All | It has been archived | Click Archived |
| Searching a word you are certain is in the project finds nothing | Search matches the project title only — not the description, and not anything inside the documents | Search a word from the title, or clear the search and use the status filter |
| A search finds nothing even though the title matches | The status filter is still applied underneath the search, and the two combine | Click All first, then search |
| Every project from one organization disappeared at once | Your last membership in that organization ended, and you hold no organization-wide role there, so the whole workspace dropped out of your view | Ask a colleague on one of those projects to add you back |
| No Administer organization button, though you administer a team | That button appears only for the Organization admin role, which is a workspace role and not the same thing as being a project's PI | See workspace/organization-roles.md |
| A collaborator created a project but it is not on your list | The dashboard does not refresh by itself; it reads the list when the page loads | Reload, or type in the search box — either re-runs the query |
Good to know#
- The square with a letter in it is the project's creator, not the last editor and not you. It carries no label or tooltip, and screen readers skip it entirely.
- The three shortcuts are shown on every row, archived ones included. Opening the editor of an archived project is not blocked from here.
- What you can actually do once a row opens depends on your project role, which
the row does not display. Editing rights belong to Principal Investigator,
Co-Investigator and Research Fellow only — see
collaboration/project-roles.md. - One filter name does not match the status underneath it. The database calls
the starting state
active; every screen calls it In Progress, and nothing in the interface ever says "active". The other four — Under Review, Completed, Published, Archived — are the stored names, title-cased.
Related#
workspace/switching-workspace.md— the workspace this whole screen is scoped to (page not written yet)workspace/creating-a-project.md— the three-step wizard behind New project (written; not published yet)workspace/requesting-to-join-an-organization.md— the form behind the stat band's second line (page not written yet)workspace/organization-roles.md— who sees Administer organization (page not written yet)collaboration/project-roles.md— what you may do once a row is openeditor/editor-overview.md— where the Editor shortcut landsreferences/overview.md— where the Refs shortcut lands
Creating a project — the new-project wizard#
CoPub has no blank "new project" form. Every project is made through a short wizard that asks what you are writing, then uses your answer to name the project, choose the first document's headings, and set which papers the citation tools may offer you.
Why you would use it. It is the only way to start a manuscript, and the two minutes you spend here decide things you cannot easily change afterwards — the project's name most of all.
Before you start#
- Where you need to be: New project, the solid button on the same line as the Research Projects heading, at the end of it. If you have no projects yet the same button repeats inside the No projects yet panel further down. The screen it opens is headed What are you writing?
- Role: any signed-in researcher. There is no project yet, so no project role applies — and you become the Principal Investigator of whatever you create.
- Switched on: the wizard itself sits behind no feature flag, and neither do
steps 01 and 02. Step 03's Smart headings is the only choice
that needs anything switched on. First a plan that includes AI: the Free
plan — every new account's — includes none, so there Smart headings is greyed
out and shows AI is coming soon when you point at it, and Standard headings
(IMRaD) is selected instead. Then three switches — all on by default, all changed per
workspace in the Admin Panel:
AI outline builder (
ai_outline) for the headings, and for the per-section guidance bullets that Standard headings (IMRaD) writes too; AI citation-assist (ai_citation) and bibliographic discovery (cite_discovery) for the literature search that shapes them. With those last two off you still get AI headings — just not literature-shaped ones, and no papers land in the project. - Also needed: nothing to create a project. For any of the AI work to produce anything, the deployment's AI credentials must be set on the server. They are not per-workspace and not per-account; see "When it doesn't work".
- Costs: creating a project is free. Smart headings spends AI credits twice — once for the headings, once for the guidance bullets — and runs one literature search, which also consumes one of your monthly Find papers searches (25 a calendar month on the free plan; the meter on Account → AI usage calls it discovery search). Standard headings (IMRaD) spends credits once, for the guidance bullets, and only when you have typed a prompt. No headings spends nothing. The Free plan includes no AI (since 2026-11-13): no AI credits, so Smart headings is greyed out with AI is coming soon and Standard headings (IMRaD) writes the six headings with no AI call and no literature search. Pro, Team and Unlimited workspaces have monthly AI credits.
There are three steps, and they are an accordion#
Exactly three, marked 01, 02 and 03. Clicking a step's header opens it and closes the others, so you can jump straight to 03 and finish without ever opening steps 1 and 2. Nothing on the screen is required, and nothing you leave blank will stop you finishing. Start Writing lives inside step 03, so that one step has to be open to press it; Skip and start writing does not.
| Step | Header | What you set |
|---|---|---|
| 01 | Fill document prompt | Document prompt · Target journal |
| 02 | Citation settings | Publish year · Impact Factor · Sources · Show page number in citations · Citation style |
| 03 | Generate headings | One of Standard headings (IMRaD), Smart headings, No headings |
Two more controls sit outside the stepper and are always visible: Skip and
start writing, and a Or import Word documents (.docx) row (covered on its
own page — workspace/importing-a-word-document.md).
How to use it#
- Open New project from the dashboard.
- In step 01, type into Document prompt — a sentence or two describing the manuscript, as in the placeholder "A research paper on the effects of climate change on marine biodiversity". As you type, a checklist under the box shows which of four details the prompt names — who is studied, where, when and what is measured — and a bar fills as it names more: Weak prompt — add the details below for better suggestions. for none or one, Good prompt — the optional details below can still help. for two or three, Strong prompt — it names who, where, when and what is measured. for all four. A detail you leave out is offered as an optional hint with examples. Before you type anything it reads Describe what you're writing — more detail, better suggestions. A prompt written mostly in a non-Latin script, such as Arabic, shows a simple length guide instead. The checklist is advice, not a gate.
- Optionally fill Target journal (placeholder "optional — e.g. The Lancet, NEJM, BMJ"). Press Next.
- In step 02, set the citation limits you want. Publish year takes a From and a To and is left empty for all years. Impact Factor offers All, 0.25+, 3+ and 10+. Sources offers External + library (the default), External only and Library only. Show page number in citations is a checkbox. Citation style offers Project default plus the ten style names as they are spelled internally — numeric, author-year, vancouver, harvard, apa, ieee, mla, chicago, ama, nature. Press Next.
- In step 03, pick a heading mode. They are listed Standard headings (IMRaD) first, Smart headings second and No headings third — but Smart headings is the one already selected when you arrive — on the Free plan, which includes no AI, Standard headings (IMRaD) is.
- Press Start Writing.
What you should see. The button reads Creating…, then the editor opens on a document named after your prompt, with a Project created. message. If you chose Smart headings or Standard headings (IMRaD) and typed a prompt, a coloured strip across the top of the editor reports what is being generated — Preparing your document…, then Generating section headings…, then Writing section guidance… — with a running clock and the note You can start writing now. The headings appear in the document when the strip disappears. The strip tracks the background job rather than your choice, so on the paths that make no AI call at all it is over before you can read it.
The seeding happens after you land, not before#
This is the single most confusing thing about the wizard, and it is deliberate. Pressing Start Writing creates the project immediately and takes you to the editor at once; the AI work then runs as a background job and writes into the document while you are already looking at it. So an empty editor is the normal first sight, not a failure. Watch the strip at the top: while it is there, work is still running.
The reason is blunt — generating headings, prose and guidance took up to a minute in testing, and doing it before the redirect made project creation itself appear to fail.
Set once, or changeable later#
| What you chose | Afterwards |
|---|---|
| Document prompt | Write-once. It is stored on the document and is what names it and seeds its headings — but nothing in CoPub displays it again or lets you edit it |
| Target journal | Fixed. Nothing in CoPub edits it after creation. It appears as a small unlabelled line under the title on the project's overview page |
| Project name | Fixed. Derived from your prompt at the moment of creation; there is no rename anywhere in the app |
| Citation limits (step 02) | Changeable per document — see citations/scope.md |
| Citation style | Changeable per document in the editor |
| Heading mode | Not a setting. It decides once what gets written into the first document; changing your mind means editing the headings yourself |
The project name being permanent is worth pausing on. Skip and start writing creates a project called Untitled, and so does Start Writing with an empty or very short prompt — and that name is what you and your collaborators will see in the dashboard from then on. Write the prompt.
Changing the citation limits or style later needs general editing rights:
Principal Investigator, Co-Investigator or Research Fellow. A
Statistician or a Research Coordinator cannot — see
collaboration/project-roles.md.
What happens if you leave#
There is no Cancel. Nothing is created until you press Start Writing, Skip and start writing, or drop in a Word file — so ← Back to Dashboard, the browser's back button, or simply closing the tab all leave no project behind. Everything you typed is discarded; the wizard keeps no draft.
One asymmetry to know: Skip and start writing still keeps the Target journal you typed, while discarding the prompt, the citation settings and the heading choice.
When it doesn't work#
| What you see | What it means | What to do |
|---|---|---|
| The editor is empty after Start Writing | Expected — the headings are generated after you land | Wait for the strip at the top to finish; it names the step it is on |
| Smart headings is greyed out and says AI is coming soon | Your workspace is on the Free plan, which includes no AI; nothing is sent to the AI service | Choose Standard headings (IMRaD) or No headings; to use AI, ask an administrator to move the workspace to Pro, Team or Unlimited |
| I chose Smart headings and got Abstract / Introduction / Methods / Results / Discussion / Conclusion | The AI outline was unavailable, so the wizard fell back to the standard skeleton. It does this silently — nothing on screen says the fallback happened | See the row below; then either accept the skeleton or rebuild the outline in the editor |
| Everything is switched on and Smart headings still produces the standard skeleton | A switch being on only makes the capability available; the deployment's AI credentials must also be set on the server. Out of credits, or a failed call, produces exactly the same silent fallback | Ask an administrator to check the server's AI credentials, and read your credit balance on Account → AI usage |
| The project is called Untitled | You pressed Skip and start writing, or the prompt was empty or too short to derive a name from | Nothing can be done — projects cannot be renamed. Create a new one with a real prompt |
| Papers I never added appear in the project's references | Smart headings searches the literature and imports up to three papers to shape the outline | Leave them; if you never cite them they are tidied away — see references/provisional.md |
| Smart headings produced headings but no papers at all | Either bibliographic discovery is switched off for the workspace, or you have used this month's 25 literature searches. Neither is announced — the outline is simply generated without the literature | Check the switch with an administrator, or read the discovery search meter under Plan limits this month on Account → AI usage |
| I set Sources → Library only and it still found new papers | The scope you set governs the citation tools afterwards; the wizard's own one-off literature search does not read it | Nothing to fix — the setting is working for everything you do next |
| A minimum Impact Factor seems to filter nothing | A floor can only exclude a paper whose impact is known; where it is unknown the paper is let through rather than silently dropped | Combine it with a narrower year window |
| "You've reached the maximum number of research groups for your account. Contact support if you need more." | Creating a project when you are in no workspace also creates the workspace, and an account may only ever create three. It is a lifetime count — leaving a workspace does not give the slot back | It only appears when nothing resolves as your current workspace. If you belong to one, switch into it from the account menu first; otherwise ask a colleague to add you to a project, or contact support |
| "Couldn't create the project. Please try again." | The write was rejected | Retry; if it repeats, report it |
| A colleague cannot change the citation settings on the document | They hold a Statistician or Research Coordinator seat; neither carries general editing rights | Only Principal Investigator, Co-Investigator and Research Fellow may edit — see collaboration/project-roles.md |
Good to know#
- "Standard headings (IMRaD)" is not an AI-free choice on a paid plan (on the Free plan it is: six headings, no AI call, no literature search). It writes six fixed headings — Abstract, Introduction, Methods, Results, Discussion, Conclusion — without asking a model, but if you typed a prompt it still makes one AI call to fill in the per-section guidance bullets, on the same AI outline builder switch and metered the same way. No headings is the only choice that touches no AI at all.
- What actually leaves CoPub when Smart headings runs. Your prompt goes to the AI model service in full, twice — once to generate the headings, once to generate the guidance bullets. Separately, its first 300 characters go to the literature service as the search query, and the titles that search returns are included in the model call so the outline reflects them. Nothing else from your workspace is sent.
- The wizard writes headings, never a full draft. Until 13 November 2026 a Full draft setting could have AI write prose under every heading in one go, with nothing for you to accept first. That option has been retired. The wizard now writes the headings — and, if you typed a prompt, the per-section guidance bullets — and the writing is yours. To have AI draft a section, use Generate on that heading in the Sections panel: it shows you the draft, and nothing goes into the document until you accept it. Documents drafted before keep their text, their version history and their AI marks.
- Project default under Citation style means "leave it alone", not
"clear it". If you have set a personal default citation style in your account,
the new document keeps that — see
account/document-defaults.md. - Every project starts with one document — named from your prompt, or Untitled if you skipped — plus one project chat channel. Both are created in the same transaction as the project.
- The step markers are honest about one step only. Step 01 turns into a tick only if you actually typed a prompt; step 02 ticks whenever you have moved past it, whether or not you changed anything; step 03 never ticks at all.
Related#
workspace/dashboard.md— where the New project button livescitations/scope.md— the citation limits from step 02, and changing them laterworkspace/importing-a-word-document.md— the .docx row on the same screenreferences/provisional.md— why the papers the wizard found may vanishcollaboration/project-roles.md— who may change what afterwardsai/ai-overview.md— credits, and the two things AI needs before it worksadmin/feature-flags.md— where a capability is switched off for a workspace
Project roles — who can do what#
Everyone on a project has exactly one role, and the role decides what they can do. There are five, and every project has exactly one Principal Investigator.
Why you would use it. Most "why can't I click this?" questions are role questions. This page is the answer, and other pages link here rather than repeat it.
Before you start#
- Where you need to be: a project's Overview shows the members and their roles. Changing someone's role needs the PI.
- Role: anyone on the project can see the roles. Only the PI can change them or transfer the PI role.
- Switched on: always available — roles are not a feature that can be switched off.
- Also needed: nothing.
- Costs: nothing.
The five roles#
| Role | Best suited for | Can edit documents | Manages members |
|---|---|---|---|
| Principal Investigator (PI) | The project lead | ✅ | ✅ |
| Co-Investigator | A senior collaborator | ✅ | ✅ |
| Research Fellow | A hands-on contributor | ✅ | — |
| Statistician | Stats / analysis specialist | — | — |
| Research Coordinator | Operational coordination | — | — |
Everyone — all five roles — can read the project and take part in its chat. There is no role that can see a project without being able to talk in it.
Only the PI can change the project's status, edit project-wide settings, approve exports and submissions, and transfer the PI role to someone else.
Co-Investigators and the PI can invite members and revoke invitations.
⚠ A Statistician cannot currently edit anything#
The role's name promises more than the product delivers today, and it is better that you know before you invite someone into it.
The permission model does define a separate "edit the Methods section only" right, and a Statistician holds it. Nothing in the product checks it. The editor asks one question — do you have general editing rights? — so a Statistician opens every document read-only, Methods included.
In practice, then, Statistician and Research Coordinator are the same seat: read the project, take part in its chat, and nothing else. If the person needs to write the Methods section, give them Research Fellow, which carries general editing rights, and rely on convention for the rest.
Everything that needs editing rights is therefore unavailable to both roles, including all the citation tools:
- Cite (finding a source for a passage)
- Find papers (searching the literature)
- Looking a paper up by DOI, ISBN or PMID
- Importing a source into the project library
For those two roles the buttons are not merely disabled — they are not rendered at all, so there is nothing to click and no error to read. If a Statistician needs to add a reference, either a colleague with editing rights adds it, or the PI changes their role.
This page previously said a Statistician "can edit the Methods section — that is
the point of the role". That was wrong, and it was wrong in the direction that
wastes someone's afternoon: they would have accepted the invitation, opened the
document and found no way to type. Tracked as B-AUTH-METHODS-ONLY-INERT-001.
How to change someone's role#
- Open the project and go to Overview.
- Find the person under Members.
- Choose the new role. (PI only.)
What you should see. Their role updates immediately, and what they can do changes on their next page load.
When it doesn't work#
| What you see | What it means | What to do |
|---|---|---|
| You cannot change anyone's role | You are not the PI | Ask the PI |
| You cannot make someone a second PI | A project has exactly one PI by design | Use transfer instead — it moves the role, it does not duplicate it |
| Someone says a button is missing | Almost always their role, not a fault | Check this table first, then whether the feature is switched off in Admin Panel → Feature flags |
Good to know#
- Roles are per project. The same person can be a PI on one project and a
Coordinator on another. Workspace-level administration is separate — see
admin/feature-flags.md. - Removing someone does not delete their work. Their edits, comments and chat messages remain attributed to them.
Related#
sharing/share-links.md— giving access to someone who is not a membercitations/cite-panel.md— needs full editing rights
The editor: writing surface#
The editor at a glance#
The writing surface: a list of the project's documents down the left, the document itself in the middle, and an outline that builds itself from your headings. This page is the orientation — what each part of the screen is, when your work is saved, and what to do when CoPub tells you someone else has been editing.
Why you would use it. Everything else in CoPub — citations, AI review, exports — acts on a document that lives here. Knowing how the screen is put together, and what "saved" actually means, is what stops you losing an hour to a banner you did not understand.
Before you start#
- Where you need to be: open a project, then choose Editor in the project navigation. The document you open is carried in the address bar, so a link to the editor reopens the same document.
- Role: Principal Investigator, Co-Investigator or Research Fellow can write. A Statistician or Research Coordinator gets the same screen with no formatting toolbar and a canvas that cannot be typed into.
- Switched on: the editor itself is always available. Which of the two writing surfaces you get is the Real-time co-editing flag — on by default; an administrator can switch it off in Admin Panel → Feature flags.
- Also needed: nothing.
- Costs: nothing. Writing, saving, the outline and Preview are all free. Only the AI actions you start from here spend credits.
A document belongs to a project#
A project holds many documents and you have exactly one open at a time. The left sidebar is that list, headed Document tabs; it is where documents are created, switched between, and — once archived — restored or deleted for good. Archiving itself is not there. That control lives in the document header, beside Rename and Duplicate, as an archive-box button that asks "Archive this document?" before it acts. Nothing you do in one document affects another, but the project's reference library, its citation style and its members are shared by all of them.
The sidebar carries, in order: a burger button that collapses the whole rail to a strip of icons, the Select template button (writers only, and it opens a modal titled New document), an Active / Archived pair, a Search docs… box that appears once the project has more than three documents, and then the documents themselves. Each one shows its title and when it was last touched — just now, 7m ago, 3d ago, and a plain date beyond a month. Archived holds documents you have put away; from there a writer can Restore one or Delete permanently. On a window narrower than 1024px the sidebar starts collapsed and a floating Tabs button brings it back.
Headings are structure, not decoration#
This is the single idea the rest of the editor is built on. A real heading is a different kind of thing from a line you made bold and large, and three separate features read it:
- The outline in the sidebar is derived from your headings, levels one to four.
- Preview and the Word export number your sections automatically —
1,1.1,1.1.1— and build a Contents block from the same headings. This happens only once a document carries two or more headings; a one-heading note is left alone rather than being surprised by a1.prefix. - Cross-references point at headings by a stable identity, so a section keeps its reference when you move it.
Text that merely looks like a heading gets none of that. See
editor/formatting-toolbar.md for the controls themselves.
The outline#
The outline sits directly beneath whichever document is open, and only beneath that one — collapse the sidebar or switch to Archived and it is not drawn. Before you have written any headings it reads "Headings you add to the document will appear here."
It lists levels one to four, indented by level, and clicking an entry scrolls the canvas to that heading. It is rebuilt on the server every time the document is saved, which is the one thing worth knowing about its timing: a heading you typed a moment ago appears in the outline once that save has landed, not as you type it.
Levels five and six are the exception in both directions — they never appear in the sidebar, but they are numbered and do appear in the Contents block in Preview and in the Word export. If a heading is missing from the outline, that is almost always why.
Edit and Preview#
One icon button in the document header switches between the two view modes — an eye while you are editing, a pencil while you are previewing. It carries no visible text; its tooltip reads Preview or Edit, naming where the click takes you. There is no third mode.
Preview is not a cosmetic zoom on the same thing — it is the compiled document. Section numbers and the Contents block are added, figures, tables and equations get their numbers, cross-references resolve, citation markers are rendered in the project's style, and Footnotes and References sections are appended. None of that is written into your document; it is produced at render time, every time, which is why the edit canvas keeps showing exactly the text you typed. Preview is read-only, so the formatting toolbar and the block controls are not there.
Zoom#
Zoom is under More tools: a menu of 50% to 200%. It scales the page on your screen and nothing else: it is not part of the document, it is not saved with it, and your collaborators do not see it. Your browser remembers your choice for the next document you open.
When your work is saved#
CoPub saves for you; there is no Save button for the document body.
With co-editing off, typing arms a save that fires about four seconds after you stop; switching document, leaving the page or starting an export sends it at once, and Ctrl/Cmd + S saves now. With co-editing on your keystrokes reach your collaborators as you make them, and a tidied copy of the document is written to the server about four seconds after an editing burst settles.
"Saved" means more than the text having reached the server. On every save CoPub cleans the markup, stamps each heading with its stable identity, and recomputes the outline, the word count and the list of references this document cites. That is why those three things move together.
The two modes differ in what they leave in the version history: with co-editing off every save adds a version, whereas with co-editing on the editor writes one version per editing session, crediting everyone who contributed to it.
There is no "Saved" indicator on screen. The honest signal is the N words count in the strip along the bottom of the canvas — it is recomputed by the server and only changes when a save has actually been accepted.
When someone else has been editing#
If another person saves the document you have open, an amber bar appears above it: Another editor saved changes to this document. with a Refresh to latest button. CoPub deliberately does not replace your canvas for you.
This happens with co-editing off. With co-editing on everyone's typing merges continuously as it arrives, so ordinary writing there raises neither the bar nor the rejection below — there is nothing to reconcile.
Two situations produce that bar, and they need different reactions.
The bar on its own means their save landed and yours are unaffected. Click Refresh to latest when you are ready. Be aware that it replaces the whole canvas with the server's copy — anything on screen that has not been saved is overwritten. Renaming a document also raises this bar, including on the screen of the person who did the renaming; that one is harmless and nothing of yours was rejected.
The bar together with a red "Someone else saved this document. Refresh to latest, then reapply your change." means your save was rejected rather than merged, so their version is intact and your last change is not stored. This is the case to slow down for: your tab is still holding the version of the document it last read, so every further save from it is rejected the same way and you can keep typing for minutes into a document that is no longer recording anything. Copy the paragraph you are working on somewhere safe, click Refresh to latest, then paste it back. (Switching to Preview also re-reads the document and unjams future saves — but it does not rescue what you already typed, so copy that out first either way.)
The block gutter#
Hover over any paragraph, heading, list, figure or table while editing and three small buttons appear just outside the left edge of that block: + inserts a new block below it, ⠿ drags it to a new position, and ✨ hands that block to AI edit. The ✨ button is only drawn when AI editing is available for your workspace. The gutter is for writers only and is absent in Preview.
When it doesn't work#
| What you see | What it means | What to do |
|---|---|---|
| Nothing under the document in the sidebar but "Headings you add to the document will appear here." | The document has no headings yet | Add real headings — see editor/formatting-toolbar.md |
| A heading is in the document but not in the outline | The sidebar lists levels one to four only; levels five and six are numbered in Preview but never listed | Make it H4 or shallower — level five and six headings only arise from ##### typed in the editor or from an imported document |
| A heading you just typed is missing from the outline | The outline is rebuilt on save, not on keystroke | Wait a second and look again |
| Clicking an outline entry does nothing | The outline jumps to the identity the server stamped on that heading when it saved, and that identity is not written back into the canvas you are typing in — so a heading created in this session has nothing on screen to jump to yet | Reopen the document (switch away and back, or reload); the entry works from then on |
| Amber Another editor saved changes to this document. | A collaborator saved — or somebody, possibly you, renamed the document. Your work is unaffected either way | Click Refresh to latest — but copy anything unsaved first, it replaces the canvas |
| That bar plus a red "Someone else saved this document…" | Your save was rejected, and every later save from that tab will be too | Copy your unsaved text, Refresh to latest, paste it back |
| No formatting toolbar and you cannot type | A read-only role, or a view share link | Check your role in collaboration/project-roles.md |
| No Zoom control on the toolbar | Zoom is under More tools; a read-only role has no toolbar at all | Open More tools → Zoom, or use your browser's zoom |
| ✨ on the gutter answers "AI isn't configured yet." | Everything is switched on, but the server has no AI credentials — a flag makes a control visible, it does not make AI work | Ask an administrator to configure the workspace's AI credentials |
| Numbers like 1.1 appear in Preview that you never typed | Automatic section numbering, which starts at two headings | Nothing — they are added at render time and are not in your text |
Good to know#
- The address bar remembers the document. Switching documents rewrites the URL, so a link to the editor reopens the one you were in — useful for pointing a co-author at the right draft.
- Renaming is one click. For writers the document title in the header is the rename control; click it, type, Save.
- Archiving is reversible; deleting is not. Archive from the document header; Archived documents can be restored from the sidebar at any time. Delete permanently asks for confirmation because there is no undo.
- A Statistician's Methods-only permission is not enforced in the editor today. The role is defined as being able to edit the Methods section, but the editor checks full editing rights and nothing else, so a Statistician sees the document read-only. If they need to write, the PI changes their role.
Related#
editor/formatting-toolbar.md— the controls above the canvas, and how to tell whether co-editing is onai/ai-edit.md— what the gutter's ✨ button openscollaboration/project-roles.md— who can editadmin/feature-flags.md— where Real-time co-editing is switched off
The formatting toolbar#
The strip of controls above your document: undo, headings, bold and italic, lists, sub- and superscript, and the More menu that holds everything else.
Why you would use it. Manuscript formatting is structural, not decorative — a real heading becomes a section in your export and an entry in the outline, whereas bold text that merely looks like a heading becomes neither.
Before you start#
- Where you need to be: open a project, then open a document from the Editor.
- Role: Principal Investigator, Co-Investigator or Research Fellow. A Statistician can edit the Methods section only; a Research Coordinator cannot edit and sees the document read-only.
- Switched on: always available.
- Also needed: nothing.
- Costs: nothing.
One editor, with co-editing on or off#
Every document opens in the same editor, and a workspace setting decides whether several people can be in it at once:
- Co-editing on (the default) — several people in the same document at once, with live presence showing who else is in it.
- Co-editing off — the same editor, toolbar and features, without live presence; it saves through the page a few seconds after you stop typing.
If you can see other people's cursors, co-editing is on. Which a workspace uses is an administrator setting.
What the controls do#
History
| Control | What it does |
|---|---|
| Undo / Redo | Step back and forward through your own changes |
Character formatting
| Control | What it does |
|---|---|
| B Bold, I Italic, U Underline | The usual emphasis |
| Strikethrough | Marks deleted text — useful while revising with co-authors |
| x² Superscript / x₂ Subscript | Chemical formulae, units, footnote markers |
| Highlight | A colour highlight for review, not part of the manuscript's meaning |
| Code | Fixed-width, for a variable name or a command |
Structure
| Control | What it does |
|---|---|
| ¶ Paragraph | Turns the current block back into ordinary body text |
| H1 · H2 · H3 · H4 | Heading levels. These are what build your outline and your export's sections |
| Bulleted list / Numbered list | Lists |
| Quote | An indented block quotation |
| Code block | A fixed-width block |
The Format controls add the rest — font, size, text colour, alignment, line spacing, indent, link, inline math and clear formatting — under More tools, or behind a Format button on a phone. Tables, figures, equations, footnotes and cross-references have buttons of their own (some under More tools when the toolbar is folded).
How to use it#
- Select the text you want to change — or just place the cursor in a paragraph if you are changing its structure.
- Click the control. Structural controls apply to the whole block; character controls apply to the selection.
What you should see. The control highlights while your cursor is inside text it applies to, so you can tell at a glance whether you are in a heading or a paragraph.
When it doesn't work#
| What you see | What it means | What to do |
|---|---|---|
| The toolbar is missing entirely | You are viewing read-only — a Coordinator, or a view share link | Check your role, or ask for edit access |
| Controls are there but nothing changes | You are a Statistician outside the Methods section | Statisticians can only edit Methods |
| Bold looks like a heading but no outline entry appears | Bold is character formatting, not structure | Use H2 / H3 instead — only real headings become sections |
| Your change vanished | With co-editing on, a collaborator edited the same text at the same moment | Check with them; with co-editing on the last write is kept |
| The heading level is wrong in the export | Heading levels map straight through to the export | Fix the level in the document, then export again |
Good to know#
- Headings are the backbone of everything else. The outline, the section navigator, per-section AI drafting and your export's structure are all built from them. Formatting text to look like a heading gives you none of that.
- Highlight is for review, not for the manuscript. Treat it as a note to yourself or a co-author.
- Undo is per person. With co-editing on it steps back through your changes, not your collaborator's.
Related#
editor/editor-overview.md— how headings drive the outline and exportscollaboration/co-editing.md— live presence and simultaneous editingcollaboration/project-roles.md— who can edit
The editor: AI#
AI in CoPub — the whole set, and what to check when one does nothing#
CoPub's AI is not one feature. The editor's AI Features row carries ten buttons, three more AI actions live off that row, and most of them share one pool of credits. This page names all of them, and then answers the question that brings most people here: the AI is doing nothing — whose fault is it, and what do I do?
Why you would use it. Because "the AI isn't working" is almost never one problem. It is usually one of four, they look different on screen, and three of the four you can fix yourself in under a minute.
Before you start#
- Where you need to be: open a document. The AI controls live on the row labelled AI Features, directly above the page.
- Role: you need to be a member of the project. Which controls appear, and which ones can keep their result, depends on your role — see Roles below.
- Switched on: every capability is on by default. An administrator can switch any of them off in Admin Panel → Organizations → your workspace → Feature flags.
- Also needed: the deployment's AI credentials, set on the server at boot. They are not per-workspace and not per-account. This is separate from the switches and is the single most common cause of "everything looks fine and nothing works".
- Costs: AI credits from a shared monthly pool on a paid plan (Pro 5,000, Team 50,000 a month) plus per-feature monthly caps; both are covered below. The Free plan includes no AI (since 2026-11-13): every AI action of a Free workspace answers AI is coming soon («الذكاء الاصطناعي قادم قريبًا») and sends nothing to the AI service.
Every AI surface in the editor#
The AI Features row runs left to right in this order — Chat · Cite · Find papers · Edit · Outline · Builder · Autocomplete · Review · Sections. (A Full draft switch sat between Builder and Autocomplete until it was retired on 13 November 2026.) It is not alphabetical: the original six were sorted that way and each later addition was slotted in beside its relative. Nothing on the row is hidden in a menu.
The switch column gives the name the switch carries in the admin panel, with the flag key an administrator will actually search for.
| Control | What it does | Its own switch | Read more |
|---|---|---|---|
| Chat | Ask questions about the open document in a side panel | AI document-assistant chat (ai_chat) |
(no page yet) |
| Cite | Suggests citations for the passage you selected | AI citation-assist (ai_citation) |
citations/cite-panel.md |
| Find papers | Searches the literature from a side-sheet | bibliographic discovery (cite_discovery) |
references/find-papers.md |
| Edit | Rewrites text you have selected. 22 commands, including Paraphrase, Expand, Make concise, Proofread, and Tense / Translate flyouts | AI selection editing (ai_editing) |
ai/ai-edit.md |
| Outline | Type a Topic, get a heading skeleton, then Insert into “” or Discard | AI outline builder (ai_outline) |
(no page yet) |
| Builder | A standalone outline workspace. The link is never switched off — but inside it, Seed with AI is a real AI call on the same switch as Outline. Building the tree by hand uses no AI | none for the link; ai_outline for Seed with AI |
(no page yet) |
| Autocomplete On/Off | Grey continuation text as you type; Tab accepts | AI inline autocomplete (ai_autocomplete) |
ai/autocomplete.md |
| Review | Six review lenses over the whole manuscript | AI proofread + claim-confidence review (ai_review) |
ai/ai-review.md |
| Sections | Per-heading guidance bullets, each with its own Generate button that drafts that section | Section prompts (section_prompts) for the panel; ai_writing for Generate |
(no page yet) |
Three more AI actions have no button on that row:
- Deep research — inside the Chat panel, below the composer. It plans
sub-questions, searches, and writes a Research report with citations.
Its own switch, Agentic AI research (
ai_agentic_chat). - Grounded continuation — press Ctrl/Cmd + Enter while typing and autocomplete retrieves from your library first, so the continuation can cite. It is deliberately a keystroke and never automatic, because retrieval is slower and costlier than the ordinary per-keystroke suggestion. Same switch as Autocomplete.
- Summarize — a 2–3 sentence AI summary of a paper, under the AI summary heading on a reference. It lives on the References screen, not in the editor, which is worth knowing because it is one of the four capped features below.
Select any text in the editor and a small floating toolbar appears over it carrying Comment, AI edit, Cite, Outline, Review, Chat and Sections. These are shortcuts to the row's buttons, not extra capabilities — each one carries the same switch and the same role gate as the button it points at.
Roles
The full capability matrix is in collaboration/project-roles.md; two rules
matter here.
Reading is enough to run AI, but not to keep the result. Review, Chat and Deep research need only read access, so a Statistician or a Research Coordinator can genuinely run them. But putting generated text into the document needs editing rights, held by Principal Investigator, Co-Investigator and Research Fellow only. Insert an outline without them and you get "You don't have edit access to this document."
Some controls are hidden from non-editors, and some are not. Exactly two disappear without editing rights: Cite and Autocomplete. Everything else on the row — Chat, Find papers, Edit, Outline, Builder, Review, Sections — renders for a Statistician or Research Coordinator.
Most of those genuinely run; you just cannot keep the output. Find papers is the one that does not run at all: the server requires editing rights for a literature search, so every query comes back "Paper discovery isn't available here." That is an inconsistency in the product — the button should have been hidden like Cite was — not something you have configured wrong.
The gates, and how to tell which one is biting#
Before either gate — the plan. The Free plan includes no AI (since 2026-11-13). In a Free workspace every AI button is greyed out and shows AI is coming soon when you point at it or tab to it, and every AI action answers AI is coming soon before anything is sent, whatever the switches, credits or credentials. Menus and panels still open, so earlier AI results stay readable. An administrator moves the workspace to Pro, Team or Unlimited in the admin panel.
On a paid plan an AI feature has to clear two independent gates, and they are not the same gate. Confusing them is the most expensive mistake a reader can make here, because one is fixable in the admin panel and the other is not fixable by anyone in the product at all.
Gate one — the switch. Each capability has a feature flag. A flag decides whether the control is drawn on screen. Every flag is on by default, so if a button is missing, somebody set an explicit override for your workspace in Admin Panel → Organizations → your workspace → Feature flags. Flags are set per organization; there is no global off switch in the panel.
Gate two — the credentials. The AI model is reached through a service key configured on the server at boot. Nothing in the product can supply it and no plan or payment affects it. If it is absent, every control still renders perfectly and every action fails.
That second sentence is the whole point of this section, and the code says it in so many words: all 26 flags can be on against a provider that cannot answer.
| Switch | Credentials | What you experience |
|---|---|---|
| On | Present | It works |
| On | Missing | Every button is there, and every action errors |
| Off | Either | The button is simply not drawn |
Read the message — it names the gate
CoPub does not use one generic error. Each failure class has its own wording, so the message tells you which gate you are on.
| The message you see | What it actually means | Who can fix it |
|---|---|---|
| "AI is coming soon" | The plan: the workspace is on the Free plan, which includes no AI. Nothing was sent | An administrator, by moving the workspace to Pro, Team or Unlimited |
| "This AI feature isn't enabled for this workspace." | Gate one. Somebody switched this capability off | An administrator, in Feature flags |
| "AI isn't configured yet." | Gate two. No AI credentials on the server | Whoever operates the deployment |
| "AI is temporarily unavailable (provider authorization). We're on it." | Gate two, differently: credentials exist but were rejected — usually expired or revoked | Whoever operates the deployment |
| "The AI provider is rate-limiting or out of quota right now…" | The AI provider's own account is out of quota. Nothing to do with your plan | Whoever operates the deployment |
| "You've used all your AI credits for this period." | Your workspace's credit pool is empty | Wait for the reset, or change plan |
| "You've reached this feature's monthly limit — it resets on …" | One of the four per-feature caps, not credits | Wait for the date shown, or change plan |
| "Too many AI requests right now — try again in a moment." | A short per-person speed limit, not a quota | Wait a few seconds |
The distinction that saves the most time: missing controls are a switch problem; present controls that error are a credentials problem. If someone tells you the flag is green and AI still fails, they have confirmed gate one and told you nothing about gate two.
Credits#
Credits are the shared pool. One credit is 1,000 tokens of input and output combined, and every call costs at least one credit however short it is. The model you are on makes no difference to the price — the rate is deliberately flat.
Your balance sits in the top bar, beside the notification bell, as AI Credits with your workspace's plan next to it (Workspace PRO, Workspace TEAM); Upgrade appears there when fewer than 300 credits are left. On the Free plan it reads AI is coming soon · Workspace FREE, with no number and no Upgrade. Inside a project's editor the Project chip beside it is not your credit plan — it is this project's AI pass, which a project lead activates from Project settings → Billing. It reads Free whenever the project has no live pass, including on a workspace that is on Pro or Team, and AI is coming soon on a Free workspace. Read your real plan off Account → AI usage, never off that chip.
| Plan | Credits per month | When they run out |
|---|---|---|
| Free | None — AI is coming soon | — |
| Pro | 5,000 | AI stops until the reset |
| Team | 50,000 | A bounded overage first — roughly 20% of the monthly pool — then it stops |
A workspace nobody has provisioned is on Free. The period is the calendar month, and credits replenish to plan level on the 1st — the AI usage page prints the exact date (on the Free plan it says AI is coming soon instead). The credit-pool error itself does not name a date; the banner in the editor carries a Resets in countdown, and the per-feature cap message does name the date.
Pro is written to soften a cap by re-running the call on a cheaper model instead of refusing. It does not do that today: the price is a flat rate per thousand tokens regardless of model, so the cheaper retry costs exactly the same and is refused identically. Treat Pro as a hard stop like Free. Team's overage is real.
Two things charge in ways worth knowing. Autocomplete charges when you accept, not when a suggestion appears, so ignoring suggestions is free. And a Deep research run is many model calls, so it is by far the most expensive single thing you can press.
The four monthly caps#
Separate from credits, four features carry a hard count per month. These stop you while you still have credits, which is why they surprise people.
| Feature | Free | Pro | Team | What one unit is |
|---|---|---|---|---|
| AI review | 2 | 30 | unlimited | One review run |
| Literature search (Find papers) | 25 | 500 | unlimited | One search |
| Paper summaries (Summarize) | 10 | 200 | unlimited | One summary |
| Grounded section drafting | 5 | 100 | unlimited | One section drafted with sources |
They count actions taken this calendar month, not credits spent, and they reset with the credit pool.
"Grounded section drafting" is the one to watch, because it is the least obvious and the tightest. It is charged by the Generate button in the Sections panel — but only when the draft actually retrieved sources from your library. An ungrounded draft is not capped at all. (Until 13 November 2026 the Full draft wizard path charged it too, once per section, so one full draft could spend the free plan's whole month; that path has been retired.)
One more rough edge, in your interest: running out of Find papers searches reports "Search failed. Please try again." rather than naming the cap. Trying again will not help. Check the meters before you conclude the search is broken.
Where to see all of this
Account → AI usage (/account/ai-usage) is the honest, complete view:
Plan, Available, Used and This month across the top, then a
Plan limits this month section carrying a used-versus-cap meter for each
of the four caps — all four appear, even at zero — and finally Usage by
feature.
Read those two sections differently. The Plan limits this month meters are real month-to-date counts and are what the caps are enforced against. Usage by feature is a token breakdown of your 25 most recent AI actions only, and says so in small print underneath; it is a shape, not a total. A Team workspace has no caps at all, so the meters section is absent there entirely.
Use that page rather than the project's billing page, which lists only two of the four caps and omits literature search and grounded drafting entirely.
How to diagnose "the AI is doing nothing"#
- Look at the button. Is the control drawn at all? Absent means a switch is off, or your role does not have it — go to step 2. Present means go to step 3.
- Check your role, then the switch. If you are a Statistician or Research Coordinator, Cite and Autocomplete are hidden from you by design. Otherwise ask an administrator to open Admin Panel → Organizations → your workspace → Feature flags and read the Effective badge — green on, grey off — on that capability's row.
- Press it and read the exact message against the table above. Do not paraphrase it to whoever you report it to — the wording is the diagnosis.
- If the message mentions credits or a monthly limit, open Account → AI usage and confirm which one. The Plan limits this month meters answer it outright.
- If the message mentions configuration, authorization or the provider, stop. Nothing in the product will fix it and no plan change will either. Report it with the message and the time.
What you should see when it is all healthy: the AI Features row with its buttons, an AI Credits number that decreases as you work, and no banner above the page. A banner with a Resets in countdown means the credit pool is at zero. Read past its heading: it says Autocomplete limit reached whenever the autocomplete switch is on, which is the default, and AI credit limit reached only where an administrator has switched autocomplete off. Both headings mean the same thing — the shared pool, not autocomplete specifically.
When it doesn't work#
| What you see | What it means | What to do |
|---|---|---|
| One AI button is missing, the rest are there | That one capability was switched off, or it is role-gated | Check your role first, then Feature flags |
| The whole AI Features row is missing | No document is open | Open a document |
| Every button is present and every action errors | Credentials, not switches — the flags cannot cause this | Report it; an administrator cannot fix it from the panel |
| "AI isn't configured yet." on a workspace where a colleague's AI works | It cannot differ by account or workspace — this condition is server-wide | Re-check that their AI genuinely worked just now |
| An action refuses while the credit chip still shows a balance | A per-feature monthly cap, not credits | Open Account → AI usage → Plan limits this month |
| "Search failed. Please try again." on every literature search | Most likely the 25-per-month search cap, which this message does not name | Check the meters before retrying |
| Everything works, then briefly refuses for a few seconds | A per-person speed limit. The tightest are the chat Peer Review Report at 3 per five minutes and Deep research at 6 per five minutes; AI review is 12/min, AI edit and chat 30/min, autocomplete 90/min | Wait and repeat |
| "A review is already running…" | You may have only one review in flight at a time | Wait for it, or stop it |
| Deep research returns a report with no web sources | Web search needs a second server credential of its own, separate from the main AI key, and it is usually not set | Open How this was researched — a step marked skipped: not_configured confirms it |
Good to know#
- Switching a flag off never deletes anything. The controls stop rendering and the documents are untouched. Switching it back on restores everything on the next page load.
- Deep research asks before it leaves the platform. It opens a consent panel offering Your library (stays in CoPub) and an optional Web search (external). Only the sub-question text is sent externally — never your identity, document or project. The How this was researched trace afterwards lists every sub-query and whether it ran or was skipped, so the consent is auditable rather than a promise.
- You can tick the web option even when it cannot work. The checkbox always appears, whatever the server or the workspace is configured to allow. If the server has no web-search credential the trace says skipped: not_configured; if the workspace's web switch is off it says skipped: flag_disabled. Either way the step is quietly skipped and the report is library-only, and the trace is the only place that tells you.
- CoPub writes your AI-use disclosure for you. Once the ledger shows AI actually touched a document, an AI-use disclosure entry appears in the document menu and offers a statement assembled from what was really used — which features, and when. It is offered only where AI was genuinely used, because a disclosure on a hand-written manuscript would be its own false statement. Nothing is inserted unless you accept it, and nothing blocks export.
- Autocomplete is on for new documents. The per-document Autocomplete toggle starts by following the workspace switch, which is on. Turning it off on one document keeps it off there even while the workspace switch stays on.
- Paying never unlocks a switched-off capability. Plans differ by credit volume, per-call output length, queue priority, the four caps, voice-minute allowance (30 / 300 / 900 per month) and storage (1 / 10 / 100 GiB) — never by withholding a feature. Every tier gets the same models. If something is off, that is an administrator's decision, not a billing one.
Related#
ai/autocomplete.md— the grey continuation text, and the grounded variantai/ai-edit.md— rewriting a selectionai/ai-review.md— the six review lenses and the 2-per-month limitcitations/cite-panel.md— the Cite panelcitations/scope.md— limiting what the AI is allowed to citereferences/find-papers.md— the literature side-sheetadmin/feature-flags.md— the off switch, for administratorscollaboration/project-roles.md— which roles can keep an AI result
Autocomplete — the grey text that finishes your sentence#
Pause while typing and CoPub offers a continuation in grey after your cursor. Press Tab to take it, or keep typing to ignore it.
Why you would use it. It carries a sentence over the line you were stuck on, in your document's own voice, without you leaving the keyboard.
Before you start#
- Where you need to be: typing in a document.
- Role: Principal Investigator, Co-Investigator or Research Fellow.
- Switched on: AI autocomplete, on by default. An administrator can switch it off in Admin Panel → Feature flags.
- Also needed: your workspace's AI credentials.
- Costs: AI credits, charged when you accept, not when a suggestion appears. Ignoring suggestions costs nothing.
How to use it#
- Type. After a short pause — about 0.6 seconds — a suggestion appears in grey after your cursor.
- Take it, change it, or ignore it:
| Key | What it does |
|---|---|
| Tab | Accept the whole suggestion |
| Alt + → | Accept one word at a time |
| Shift + Tab | Ask for a different suggestion in the same place |
| Shift + ← / → | Cycle back through this session's recent suggestions |
| Ctrl/Cmd + / | Ask for a suggestion on demand, without waiting for a pause |
| Anything else | Dismisses it and cancels the request |
What you should see. Grey text after your cursor, with a small bar offering Accept, New and Refine. On accept the text becomes ordinary black text.
Citations in a suggestion#
If a suggestion draws on papers in your library, it can arrive with citations already in it. Those are real citations, not decoration: accept the suggestion and the markers become proper linked citations that appear in your bibliography.
When it could not find a source, it says so. A suggestion that asked to be grounded but matched nothing in your library is marked "no sources found — uncited" in the bar. That is not an error and the text is often still worth accepting — it means this sentence has no support behind it, so if it makes a claim, cite it before you submit.
You will see that marker more often when your library is thin, when the document is scoped to a collection that matches little, or when literature search is off.
Refine#
Refine ▾ regenerates the suggestion with steering — either a preset (for example, asking it to draw on your sources) or your own instruction.
When it doesn't work#
| What you see | What it means | What to do |
|---|---|---|
| No grey text ever appears | Autocomplete is switched off for the workspace, or your role cannot edit | Check Feature flags, then your role |
| Grey text appears, accepting does nothing | The document is read-only for you | Check your role |
| Nothing appears and no error | Suggestions need a pause — if you type continuously, each keystroke cancels the request | Stop typing for a moment, or press Ctrl/Cmd + / |
| Every request errors | Switched on but the workspace's AI credentials are missing | An operator fix |
| "no sources found — uncited" on every suggestion | Your library has nothing matching this passage | Add references, widen the citation scope, or cite manually |
| Credits fall faster than expected | Accepting is what charges — including one word at a time | Ignore suggestions you do not want rather than accepting and deleting |
Good to know#
- Suggestions are per document and per position. Moving the cursor abandons the suggestion; it is not queued.
- Accepting one word at a time still charges for the suggestion, because the whole continuation was already generated.
- It never edits what you have written. Autocomplete only ever adds after your cursor. To change existing text, use AI edit.
Related#
ai/ai-edit.md— changing text you have already writtencitations/cite-panel.md— adding a citation deliberatelyaccount/ai-usage-and-credits.md— credits and the per-feature limits
AI edit — rewriting text you have already written#
Select a passage, choose what you want done to it, and CoPub proposes a rewrite. You see the proposal before anything changes, and you decide whether to keep it.
Why you would use it. Autocomplete adds new text; this changes existing text. It is what you reach for when a paragraph says the right thing badly — too long, too casual, too confident, or in the wrong shape.
Before you start#
- Where you need to be: in a document, with text selected.
- Role: Principal Investigator, Co-Investigator or Research Fellow.
- Switched on: AI editing, on by default. An administrator can switch it off in Admin Panel → Feature flags.
- Also needed: your workspace's AI credentials.
- Costs: AI credits.
What you can ask for#
The commands are grouped by intent.
Strengthen — same content, better made
| Command | What it does |
|---|---|
| Improve fluency | Smooths the prose without changing the meaning |
| Paraphrase | Says the same thing differently |
| Simplify | Plainer language |
| Strengthen argument | Makes the reasoning harder to dismiss |
| Add a counter-argument | Adds the objection a reviewer would raise |
Transform — same content, different shape
| Command | What it does |
|---|---|
| Convert to bulleted list / numbered list | Prose into a list |
| Convert to prose | A list back into paragraphs |
| Convert to table | Structured content into a table |
| Expand | More detail |
| Make concise | Shorter, same substance |
| Tense ▸ | A submenu — change the tense |
| Translate ▸ | A submenu — translate the passage |
Academic — register and stance
| Command | What it does |
|---|---|
| More formal | Raises the register |
| Technical precision | Tightens terminology |
| Increase claim confidence | States the claim more firmly |
| Hedge claim confidence | States it more cautiously |
| Proofread | Grammar and mechanics on this passage only |
The two confidence commands are the ones to use deliberately. Increase and Hedge change how strongly your text asserts something without changing the evidence behind it. Use Hedge when a reviewer would say you have overstated a finding; be careful with Increase, and check the claim is actually supported by what you cited — AI review's Claim confidence lens is the check for that.
Generate — new material from what you selected
| Command | What it does |
|---|---|
| Summarize | A shorter statement of the passage |
| Opposing argument | The case against |
| More depth | Develops the point further |
| Make longer | Extends it |
You can also type your own instruction instead of picking a command.
How to use it#
- Select the text.
- Open AI edit and choose a command, or type your own instruction.
- The proposed rewrite streams into a panel — your document is not changed yet.
- Accept to replace the selection, or discard to leave it as it was.
What you should see. The proposal in the panel, then — on accept — your selected text replaced in place.
When it doesn't work#
| What you see | What it means | What to do |
|---|---|---|
| The command is greyed or missing | Nothing is selected — AI edit always works on a selection | Select the passage first |
| AI edit is absent entirely | Switched off for the workspace, or your role cannot edit | Check Feature flags, then your role |
| The panel opens and errors | Switched on but the workspace's AI credentials are missing | An operator fix |
| The rewrite dropped my citations | It should not — citations in the selection are preserved through the rewrite | Check the citation is still in the accepted text; if it genuinely vanished, report it |
| The result is longer when I asked for shorter | Model behaviour, not a setting | Discard and try Make concise again, or select a smaller passage |
Good to know#
- Nothing changes until you accept. Discarding leaves the document byte for byte as it was, and costs you nothing beyond the credits already spent generating.
- Citations survive a rewrite. If the passage you selected contained citations, they come through as real citations in the proposal, not as raw text.
- Select less rather than more. A tight selection produces a better rewrite than a whole section, and costs fewer credits.
- It only touches your selection. Nothing outside it is read or changed.
Related#
ai/autocomplete.md— adding new text rather than changing existing textai/ai-review.md— checking claims across the whole documentcitations/cite-panel.md— adding a source for a claim you just strengthened
AI review — checking a draft before you submit#
AI review reads your document and reports what a careful reader would flag: grammar and phrasing, claims your own citations do not actually support, a reviewer-style assessment, and problems with the sources themselves.
Why you would use it. It catches the things that get a manuscript sent back — an overstated claim, a citation that does not say what you think it says, a retracted reference — while you can still fix them.
Before you start#
- Where you need to be: open a document, then Review.
- Role: Principal Investigator, Co-Investigator or Research Fellow.
- Switched on: AI review, on by default. An administrator can switch it off in Admin Panel → Feature flags.
- Also needed: your workspace's AI credentials, except for Source quality, which does not use the AI model at all.
- Costs: AI credits, and a separate monthly limit — 2 review runs per period on the free plan (30 on paid). This limit stops you before your credits do. Source quality is free and does not count against either.
The six lenses#
The review hub shows six cards. Run any of them on its own.
| Lens | What it reports |
|---|---|
| Full review | Runs the set in one pass — use it when you just want everything checked |
| Proofread | Grammar, punctuation, word choice, formality, passive voice, repetition and formatting, each with a suggestion and a major / minor label |
| Claim confidence | Every substantive claim graded against your own cited sources: misrepresented · contradicted · unsupported · weakly supported · overstated · unverifiable |
| Peer assessment | A structured assessment of the manuscript as a whole |
| Peer review | A journal-reviewer-style pass plus a scorecard — writing-craft scores out of 10 with rationales, strengths, weaknesses and questions for the authors |
| Source quality | Checks your references for retraction, preprint and rarely-cited signals. Uses no AI and costs nothing |
Tone of voice is not one of these, even though it sits directly beneath them. It is a separate panel with its own Check tone button — see
ai/tone-of-voice.md.
How to use it#
- Open the document and click Review.
- Pick a lens and click its Run button, or Run review for the full pass.
- Watch the counter — it reports progress as X of N sections.
- When it finishes, read the findings in the panel.
- Optionally enter Review Mode to walk the suggestions inside the document: the editor locks while you triage, Y accepts a suggestion and N rejects it.
What you should see. Each card shows its result instead of "Not run yet", and the panel lists findings you can click through to their place in the text.
You can navigate away. A run keeps going if you leave the document, and you get a notification when it finishes.
When it doesn't work#
| What you see | What it means | What to do |
|---|---|---|
| All six cards say "Not run yet" and the body says "No review yet for this document." | Nothing has been run on this document | Pick a lens and click Run |
| Review is not in the toolbar | Your role lacks editing rights, or an administrator switched AI review off | Check your role, then Feature flags |
| The run refuses while you still have credits | You have hit the separate per-period review limit — 2 on the free plan | Wait for the period to reset, or move to a paid plan. Source quality still works: it is not limited |
| Everything is visible but every run errors | The workspace's AI credentials are missing | An operator fix — report it with the time |
| Claim confidence says a claim is unverifiable | It could not be checked against your cited sources — often because the claim has no citation | Cite the claim, then re-run |
Good to know#
- Scores are about your writing, not your science. They measure how well your own citations support your sentences and how clearly the manuscript is organised. They are explicitly not a judgement of clinical correctness, and the panel says so on every run.
- Source quality is the cheapest useful check. It costs nothing and catches retracted references, which is the failure most likely to be noticed by a reviewer.
- Run history is kept. Past runs can be reopened read-only with their scores, and a peer-review report can be downloaded.
- Feedback is recorded. 👍 / 👎 on a suggestion opens a short form.
Related#
ai/tone-of-voice.md— the separate tone panelcitations/cite-panel.md— fixing a claim that has no sourcecitations/linting-and-retractions.md— what Source quality is checking
Citations#
Citations at a glance — what one actually is, and every way to make one#
A citation in CoPub is not the text you see. What the document stores is a
pointer to a paper in this project's reference list, and the [Smith 2024]
you read on the canvas is just a hint the editor prints so the marker is not
blank. The real citation — a bare superscript ⁷ under IEEE, Vancouver, AMA or
Nature; (Smith, 2024) under APA, Harvard, MLA or Chicago — is worked out by the
server every time the document is previewed or exported.
Why you would use it. Because it explains almost everything else on this page: why the marker in the editor does not match your journal style, why you cannot put the cursor inside one, why one Backspace deletes the whole thing, why the numbering fixes itself when you move a paragraph, and why the AI can leave a sentence uncited but can never cite a paper that does not exist.
What a citation actually is#
Every citation is one object — an atom. The editor treats it the way it treats an image: you can select it, drag it or delete it, but you cannot type inside it. That is deliberate. Before it became an atom, pressing Enter in the middle of a citation label split it across the break and duplicated it, eating the prose in between.
What the atom actually holds is an opaque identifier — the reference's public
id, a twelve-character code like K7M2X9ABCDEF. That id names a paper and
nothing else: no author, no year, no number, no journal. The [Smith 2024] you
can see is a disposable label printed beside it, and everything a reader
eventually sees is worked out afresh from the id. Which is why:
- Renumbering is automatic. Move a paragraph and the numbers re-sort, because they were never stored.
- Changing citation style changes every marker at once. The document did not need editing; only the lookup rule changed.
- A citation cannot drift out of date. Correct a paper's year on the References page and every marker to it corrects itself in Preview and in every export.
- A citation to a paper that has left the project cannot silently pretend otherwise — see On export below.
Click any marker and a small editor opens with Narrative, Prefix (e.g. see), Page, Suffix (e.g. emphasis added) and Apply, plus View to jump to the paper in References and Remove to delete the marker while keeping your sentence. It works on every marker regardless of how the marker got there.
Before you start#
- Where you need to be: inside a document — open a project, then open a document from the Editor. A few routes below start somewhere else and say so.
- Role: Principal Investigator, Co-Investigator or Research Fellow — nobody else. A Statistician and a Research Coordinator both get a read-only canvas, so no citation control of any kind is shown to either. Do not expect a Statistician to be able to cite inside the Methods section: the Methods-only permission exists in the role table and is read by no screen, so in practice a Statistician cannot edit any part of a document.
- Switched on: four routes are behind no flag at all — picking a paper from
your own list (both the toolbar and
@), pasting a DOI, and Copy and Cite in the full-page PDF reader. The rest are flag-gated, and every flag is on by default — an administrator can switch one off for the whole workspace in Admin Panel → Feature flags. - Also needed: at least one paper reachable — in the project's reference list for the manual routes, or findable for the rest. Copy and Cite additionally needs that paper to have a PDF attached.
- Costs: citing a paper you already have costs nothing. The AI routes spend credits, and two of them draw on separate monthly allowances — 25 literature searches and 5 grounded drafts per calendar month on the free plan.
Every way to make one#
There are thirteen. They differ in who chooses the paper — you, the catalogue, or the model — but they all end in the same atom, and once inserted nothing downstream can tell them apart.
You already know which paper you want
| Where | What it does | More |
|---|---|---|
| Cite on the toolbar | Opens a picker of this project's own reference list and drops the marker at the cursor. Ctrl+Shift+C opens the same picker, and so does / then Cite. |
citations/manual-picker.md |
Typing @ in the document |
Opens the same list at the cursor and filters as you type. | citations/manual-picker.md |
| Pasting a DOI | A small prompt offers Cite, which fetches the paper, adds it to the project and inserts the marker. This is the one citation route that never touches a literature search. | citations/paste-doi.md |
| Copy and Cite in the PDF reader | Select a passage while reading a paper's PDF and this puts the quotation and a working citation on the clipboard; paste it into your document. Needs a paper with a PDF attached: open it from References → Read for the full-page reader, or from Read on a suggestion in the Cite panel for the side panel beside your document. | (no page yet) |
CoPub finds the paper for you
| Where | What it does | More |
|---|---|---|
| Cite in the AI row | Select a sentence you have written and it looks for papers that support it — your library first, then the published literature. | citations/cite-panel.md |
| Find papers in the AI row | A search box against the published literature; each result has its own Cite button, which imports the paper and inserts the marker. | ../references/find-papers.md |
The AI writes and cites as it goes
| Where | What it does | More |
|---|---|---|
| Autocomplete ghost text | When the grey suggestion is grounded in your sources, accepting it inserts real citation atoms along with the words — including when you accept one word at a time. | ../ai/autocomplete.md |
| Generate on a section, then Accept | Drafts prose for one heading with citations already placed; the panel shows you each one before you accept. | (no page yet — the button sits on each heading's card under Section prompts) |
| Edit in the AI row | Commands that introduce a new claim — Strengthen argument, Add a counter-argument, Opposing argument, Expand, More depth, Make longer, Increase confidence, Technical precision, and any instruction you type yourself — may attach a citation to the claim they add. The rewriting commands cannot. | ../ai/ai-edit.md |
Turning citations that are already text into real ones
| Where | What it does | More |
|---|---|---|
| Match citations in this document | Finds the loose markers already in your prose — [1], (1), (Smith, 2024), [Karim 2023], superscript numbers — and binds each to a paper, so they start behaving like citations. It has an odd home: press Select template above the document list, and the link is at the bottom of the Citation settings card in the New document dialog that opens — beside the citation-scope form. |
(no page yet) |
| Pasting a manuscript that has a References section | The paste is intercepted with Import references from this paste?, which offers Import + link: the reference list becomes real references and the inline markers become real citations. | (no page yet) |
| Or import Word documents (.docx) on the New project screen | A .docx that CoPub itself exported arrives with its citations intact, each cited paper copied into the new project on the way. Three conditions: the file must be one CoPub produced, this must be project creation, and you must still be able to read the project it was exported from — otherwise each marker lands as the plain text it was. |
(no page yet) |
On export#
Nothing you see in the editor is what ships. Preview and every export re-read the atoms and rebuild the citations from scratch:
- Each marker is rendered in the document's citation style and, for numeric
styles, numbered in the order the markers first appear. Consecutive numbers
collapse the way journals set them —
⁵,⁶for two,¹⁻³for a run. - Each marker becomes a link to its own bibliography entry. In Word that becomes a real internal hyperlink and bookmark; in PDF and HTML it jumps natively.
- The References list is generated from exactly the atoms that resolved, in the same order, so the list and the numbers cannot disagree.
- LaTeX is the exception, on purpose.
.texexport writes\cite{...}and ships areferences.bibbeside it, leaving the formatting to LaTeX and BibTeX where it belongs. - A citation to a paper that is no longer in the project is not hidden. The label you wrote survives, carries a tooltip naming the missing id, is skipped by the numbering, and the References section gains a note listing every id it could not resolve. The commonest cause is copying a document from another project, which does not bring that project's references with it.
- A paper retracted since you cited it is flagged in place rather than removed — a wrapper on the marker warns you to verify it before submitting. Deleting it would rewrite your argument and hide the problem.
Why a citation can never be invented#
This is the one guarantee worth understanding in detail, because it is what makes the AI routes safe to use on a manuscript you will submit.
The model is never asked for a citation. It is told, in the prompt itself, to cite by writing an opaque token and "never write an author name, year or number yourself", and to leave a claim uncited rather than attach a source that does not support it.
Every token is then checked, by the same resolver your own click goes through — but set stricter. A token becomes a citation only if the id is real, the paper belongs to this project, and the paper is not known to be retracted. That third test is the one your own click does not face, deliberately: you may cite a retracted paper by hand, because writing about a retraction is often the point of the paragraph. The model may not choose one for you.
Anything that fails is deleted, not flagged. A token the model invented, one pointing at another project's paper, or one naming a retracted work simply vanishes from the text before you ever see it. The sentence ships without a citation rather than with a false one.
You can watch this happen. In the section-draft panel each citation appears as a small chip before you accept; a source that could not be verified appears struck through and labelled "unverified", with a tooltip reading "This source could not be verified and will be removed on Accept". Ghost text applies the same rule as it streams, holding back a half-arrived token rather than showing you half of one.
The honest consequence: a grounded draft may carry fewer citations than you expected. That is the design working, not failing — authenticity is non-negotiable, density is best effort.
When it doesn't work#
| What you see | What it means | What to do |
|---|---|---|
| No citation control anywhere in the editor | Your role is read-only on the canvas — a Statistician or Research Coordinator gets no toolbar at all | Check your role on the project Overview |
| The Cite panel opens but every attempt errors | Everything is switched on and it still fails: the flag decides whether the control appears, but the AI routes also need the workspace's AI credentials, which are a server setting | Report it with the time — no account-level setting fixes this. The manual routes keep working meanwhile |
Typing @ does nothing |
The project has no references yet, or the @ has a letter or punctuation directly before it |
Add a reference; put a space before the @; or use the toolbar Cite, or / then Cite |
The marker reads [Smith 2024] but your style is numeric |
Expected — that is the editing hint, not the citation | Open Preview, or export |
| A marker whose tooltip reads "Reference … not found in this project" | The paper is not in this project — usually because the document was copied here from another one | Re-cite it with the picker, or add the paper to this project. Exports list every unresolved id under References so you can work through them |
| You don't have edit access. when citing a search result | The import behind it needs full editing rights | See ../collaboration/project-roles.md |
| You pasted a manuscript with a References section and nothing was offered | The reference list could not be read as one (each entry on its own line, numbered or author-year) | Use Match citations in this document after pasting |
| An AI paragraph has fewer citations than you expected | Unsupported tokens were stripped fail-closed | Add the papers to your library and re-run, or cite by hand |
Good to know#
- A citation is a point, never a wrap. With a whole paragraph selected the marker still lands at the end of it. Inserting across blocks used to duplicate the marker into each one and destroy the text between.
- Every route ends in the same place: a paper in this project. The routes that search outside import the paper first and cite the imported copy — there is no such thing in CoPub as a citation to a paper the project does not hold. It is also why a document copied from another project arrives with citations that no longer resolve.
- A paper found for you is not kept unless you cite it. Papers imported by a
literature search are provisional and are swept away if you never use them; see
../references/provisional.md. - Chat is not a citation route. Adding an assistant answer to your document inserts it as plain paragraphs; anything citation-shaped in it is text, not a citation, and will not reach your bibliography.
- Nothing here decides which papers you are allowed to cite. That is a
separate per-document setting; see
citations/scope.md.
Related#
citations/manual-picker.md— picking the paper yourselfcitations/cite-panel.md— the AI path, and what leaves CoPub when it runscitations/paste-doi.md— the route that works with literature search switched offcitations/scope.md— restricting which papers may be cited../references/overview.md— the reference list every citation resolves against../references/provisional.md— why a discovered paper can disappear../ai/ai-overview.md— every AI feature, and what to check when one does nothing../collaboration/project-roles.md— which roles can cite../admin/feature-flags.md— where a capability is switched off
Citing by hand — picking the paper yourself#
Put the cursor where the citation belongs, choose a paper from your project's own reference list, and CoPub drops the marker in. No passage to match, no suggestion to accept — you pick.
Why you would use it. You already know which paper supports the sentence. You do not need anything found for you; you need it inserted, correctly, without leaving the line you are writing. This is also the path that still works when the AI features are switched off or the workspace's AI credentials are not configured — nothing here talks to an AI service at all.
Before you start#
- Where you need to be: inside a document — open a project, then open a document from the Editor. Place the cursor where the citation should sit.
- Role: Principal Investigator, Co-Investigator or Research Fellow. A Statistician and a Research Coordinator get a read-only canvas with no formatting toolbar, so no citation control is shown to them at all.
- Switched on: nothing to switch on. This is not behind a feature flag and it is not behind AI, and the controls are the same with co-editing on or off.
- Also needed: at least one paper in the project's reference list. Add papers on the project's References page, or by pasting a DOI into the document.
- Costs: nothing. No AI credits, no monthly allowance.
It searches your library, and only your library#
The picker lists the references belonging to this project — nothing else. It never searches the published literature, and it makes no network request when you type: the whole list is delivered with the page and filtered inside your browser.
Two kinds of reference are deliberately left out:
- Archived references, which you have already removed from the list.
- Provisional references — papers a literature search found for you but that you have not cited yet. They last a day from the moment they are found and are not part of your curated library, so they are not offered here. Citing one from the Cite panel — or pressing Save to references while reading it — makes it permanent, but this picker's list was built when the page loaded, so reload before you go looking for it.
If the paper you want is not in the project yet, add it first. Nothing in this screen can reach outside the project.
Where the citation controls are#
The same with co-editing on or off:
- A Cite button on the formatting toolbar, and
Ctrl+Shift+C. /then Cite.@and a few letters, which opens the picker at the cursor already filtered (below).
How to use it — the toolbar picker#
- Put the cursor where the marker should go.
- Click Cite on the formatting toolbar, or press Ctrl+Shift+C.
- Click the paper you want.
What you should see. The panel closes and a short marker appears at the
cursor — for example [Smith 2024], or [Smith et al. 2024] for a multi-author
paper. That short form is an editing hint, not the final citation: Preview and
every export rewrite it into the document's citation style. A numeric style —
IEEE, Vancouver, AMA or Nature — renders there as a superscript number with no
brackets (text¹), even though the canvas still reads [Smith 2024]. The four
author-date styles render inline, and not identically: APA and Harvard
give (Smith, 2024); Chicago drops the comma — (Smith 2024); and MLA is
author-page, so it prints no year at all — (Smith), or (Smith 23) once you set
a page.
The @ shortcut — citing without leaving the keyboard#
It works with co-editing on or off, like this:
- Type
@at the start of a line or straight after a space. The picker opens at the cursor immediately — there is no minimum number of characters; a bare@shows the whole list. - Keep typing to filter. Every keystroke narrows the list against the paper's
authors, its year and its title, so
2024or a word of the title works as well as an author's surname. - Move with the ↑ and ↓ arrows. The first match is highlighted already, so often you can skip this.
- Press Enter. Escape closes the picker and leaves your
@as typed text.
The @ you typed is consumed — it is the trigger, not part of the document — and
is replaced by the citation marker.
Two things cancel it, both deliberately: typing a space after the @ (you are
writing prose, not citing), and typing @ immediately after a letter or
punctuation with no space in front of it — which is why [email protected]
survives untouched.
Which one to reach for#
Use @ when you can recall the paper. It is much the faster of the two: no
mouse, no menu, and the list narrows as you type. For a writer who knows their own
library it is two seconds.
Use the toolbar picker when you are browsing rather than recalling, or when you want to see the whole list. Both insert the plain parenthetical form; set the narrative form or a page on the marker afterwards.
That is not a dead end, though: click any inserted marker — however it got
there — and a small editor opens with Narrative, Prefix (e.g. see),
Page, Suffix (e.g. emphasis added), Apply, plus View to jump to the
reference, Read source to open the paper's own text, and Remove to delete the
marker while keeping your sentence (Tab moves between them; Enter or Space
runs the button that has the focus, and Enter in a field applies). So the
fast path is to cite with @ and refine afterwards.
When it doesn't work#
| What you see | What it means | What to do |
|---|---|---|
| No Cite button on the toolbar | Your role is read-only in the editor — a Statistician or Research Coordinator gets a canvas with no toolbar | Check your role on the project Overview; ask a PI or Co-Investigator to change it if it is wrong |
| No references in this project yet. | The project's reference list is empty | Add papers on the project's References page |
Typing / does nothing |
The / menu only opens as the first character of a line |
Press Enter for a fresh line, type /, then choose Cite — or just click Cite on the toolbar |
Typing @ does nothing |
The project has no references yet, or the @ has a letter or punctuation directly before it |
Add a reference; or put a space before the @ |
| A paper you added a few minutes ago is missing from the list | Everything is switched on and nothing is broken: the picker's list is fixed when the page loads, and it does not refresh while you keep the document open | Reload the document. The paper will be there |
| A paper found for you by a literature search is missing | It is still provisional — found, but not yet kept, so it is not part of your library | Cite it once from the Cite panel, or press Save to references while reading it. Either makes it permanent — but the picker's list is still the one loaded with the page, so reload before you look for it |
| No references match. while filtering | The text after @ appears in no paper's authors, year or title |
Clear the box and scroll; try a surname on its own |
The marker reads [Smith 2024] but your style is numeric |
Expected — that is the editing label | Open Preview, or export; both render the real style, which for a numeric style is a superscript number, not [1] |
Good to know#
- The
@filter matches more than names. The year and the title are searched too, so typing@2024finds every paper you have from that year. - The marker is a single object. You cannot put the cursor inside it or edit its text, and one press of Backspace removes the whole thing. That is intentional; half-deleted citations were a real source of corrupted documents.
@means two different things on this screen. In the document body it cites a paper; in a comment box it mentions a person. They are separate features that happen to share a key.- This path never sends anything anywhere. The filtering happens in your browser over a list your project already owns, so citing this way involves no AI service and no external catalogue — worth knowing for a manuscript you would rather not have leave CoPub.
Related#
citations/cite-panel.md— the AI path: find a source for a sentence you have writtencitations/paste-doi.md— adding a paper you already have the DOI forcitations/scope.md— limiting which papers may be citedreferences/provisional.md— why a discovered paper is not in this list yetcollaboration/project-roles.md— which roles can editadmin/feature-flags.md— where co-editing is switched off
Cite — find a source for something you have written#
Select a sentence you have written, click Cite, and CoPub looks for papers that support it — first in your project's own library, then, if it finds nothing good enough there, in the published literature. Clicking a result inserts a real citation at your cursor and adds the paper to your bibliography.
Why you would use it. You have written a claim and you know it needs a source, but finding the right paper means leaving your manuscript, searching a database, copying the reference in, and then formatting it. This does all four without you leaving the sentence.
Before you start#
- Where you need to be: inside a document — open a project, then open a document from the Editor. Select the text you want to support, then use Cite in the toolbar, or the Cite button on the small toolbar that appears over your selection.
- Role: Principal Investigator, Co-Investigator or Research Fellow. A Statistician can edit the Methods section but does not have full editing rights, and a Research Coordinator has none — for those two roles the Cite button is not shown at all.
- Switched on: AI citations, on by default. An administrator can switch it off for the whole workspace in Admin Panel → Feature flags.
- Also needed: your workspace's AI credentials must be configured, because the passage has to be understood before anything can be matched to it. Searching the published literature is a second, separate switch — see Two tiers below.
- Costs: searching your own library costs AI credits. Searching the published literature additionally uses one of your workspace's monthly literature searches — 25 per period on the free plan.
Two tiers, and why it matters#
Cite looks in two places, in order:
- Your project library — the papers you have already collected. Always searched.
- The published literature — OpenAlex, the open catalogue of research papers. Searched only if literature search is switched on for your workspace.
Results from the second tier carry a New badge, meaning you do not have this paper yet. Clicking Cite on one adds it to your library as well as citing it.
Your text leaves CoPub when the second tier runs. To find a matching paper, up to the first 300 characters of the passage you selected are sent to OpenAlex as the search query. OpenAlex is an international service, so that request leaves the Kingdom. Your document as a whole, your library and your project details are never sent, and every one of these searches is recorded in your workspace's audit trail. If that is not acceptable for a given manuscript, ask your administrator to switch literature search off — your own library will still be searched, and citing from it never leaves CoPub.
How to use it#
- In your document, select the sentence or claim you want to support.
- Click Cite.
- The panel opens on "Looking through your library…" while it searches.
- Read the results. Each shows the paper's title and authors; a New badge means it came from the published literature and is not yet in your library.
- Click a result to cite it.
What you should see. The panel closes and a citation marker appears in your
text at the point you selected — for example [Alharbi 2024]. The paper appears in
your References list and in the bibliography of anything you export.
When it doesn't work#
| What you see | What it means | What to do |
|---|---|---|
| No Cite button anywhere | Either your role does not have full editing rights, or an administrator switched AI citations off | Check your role on the project Overview. If you are a PI, Co-Investigator or Fellow, ask your administrator to check Feature flags |
| "Nothing in your library matched this passage." | Your library was searched and nothing fitted — and literature search is off, so the published literature was never looked at | Add candidate papers to your library, or ask your administrator to switch literature search on |
| "Nothing matched this passage — not in your library, and nothing found in the literature." | Both tiers ran and genuinely found nothing | Try selecting a shorter, more specific claim. A whole paragraph makes a poor query; one sentence with its key terms works better |
| The panel opens but every attempt errors | The feature is switched on but the workspace's AI credentials are missing | This is an operator fix, not something you can resolve from your account. Report it with the time it happened |
| A result you expected is missing | It may be retracted — Cite refuses to suggest retracted papers | Search References directly if you need to cite it deliberately, e.g. to discuss the retraction |
| "Suggested citations" appears but nothing is listed | The search is still running | Wait; the panel fills in when it returns |
Good to know#
- You can dismiss the panel while it is still searching. Press Close or click outside it and the search stops. It will not reopen over your work later.
- Papers found in the literature but never used are not kept. A paper added by a search you did not cite from is discarded automatically after about a day, so browsing does not clutter your library. Cite it and it stays for good.
- If a paper you have cited is later retracted, its marker in your text is flagged with a warning so you find it before submitting.
- Limiting where citations come from. If your document has a collection set as its citation scope, the search of your library is narrowed to that collection. It does not narrow the literature tier — a newly discovered paper is not in any of your collections yet, so there is nothing to match against. To stop external results entirely, set the document's sources to library only, which is a separate setting on the same form.
Related#
citations/scope.md— limiting citations to one collectioncitations/paste-doi.md— citing a paper you already have the DOI forreferences/find-papers.md— searching the literature without a passage to matchcollaboration/project-roles.md— which roles can edit
Pasting a DOI — citing a paper you already have the identifier for#
Paste a DOI into your document and CoPub offers to turn it into a real citation: it fetches the paper's details, adds it to your library, and inserts the marker.
Why you would use it. You already know which paper you want — a colleague sent the DOI, or you have it from a reference list. This is the shortest path from that identifier to a formatted citation.
This is the citation path that still works when literature search is off. Cite and Find papers both search external databases and can be switched off for a workspace; a DOI lookup is a direct fetch of one paper you named, so it remains available. If your workspace has discovery switched off, this is how you cite.
Before you start#
- Where you need to be: typing in a document.
- Role: Principal Investigator, Co-Investigator or Research Fellow. The lookup and the import are both restricted to full editing rights.
- Switched on: always available — it does not depend on the literature-search setting.
- Also needed: the DOI itself. Any of these forms work:
10.1001/jama.2024.1234,doi:10.1001/…, or the fullhttps://doi.org/…URL. - Costs: no AI credits. It is a direct lookup, not a model call.
How to use it#
- Paste the DOI into your document.
- A small prompt appears offering Cite, Link or Plain.
- Choose Cite.
What you should see. The pasted text is replaced by a citation marker, and the paper appears in your References list and in your bibliography.
Choosing Link keeps it as a hyperlink; Plain leaves the text exactly as pasted.
When it doesn't work#
| What you see | What it means | What to do |
|---|---|---|
| "That doesn't look like a DOI." | The pasted text was not DOI-shaped | Check for a stray character; a DOI starts 10. followed by a slash |
| "Too many lookups — try again in a moment." | Repeated lookups are rate-limited | Wait a moment. This exists so pasting a long list cannot be used to hammer the lookup service |
| "You don't have edit access." | Your role lacks full editing rights | A Statistician or Coordinator cannot use this — see collaboration/project-roles.md |
| "Couldn't resolve that DOI." | The DOI is well-formed but the lookup service does not recognise it | Check it resolves at doi.org. Very new papers sometimes lag |
| No prompt appears at all | The paste was not recognised as a DOI | Paste the DOI on its own rather than inside a sentence |
Good to know#
- Pasting the same DOI twice does not duplicate it. The DOI identifies the paper, so the second paste resolves to the reference you already have.
- This does reach outside CoPub — the DOI is sent to Crossref to fetch the paper's details. Only the identifier is sent, never your text. That is the difference from Cite, which sends part of the passage you are writing.
- The paper is a permanent library entry immediately. Unlike a paper found by searching the literature, one you named by DOI is kept from the moment you cite it.
Related#
citations/cite-panel.md— when you do not know which paper you needreferences/provisional.md— why a searched paper behaves differentlycollaboration/project-roles.md— who can use this
Citation scope — controlling which papers may be cited#
A per-document setting that narrows what the citation tools are allowed to offer: by collection, by year, by open access, by journal impact, and by whether the literature may be searched at all.
Why you would use it. A systematic review restricted to trials since 2015, or a chapter that may only cite the papers your team has already screened. Rather than checking each suggestion by hand, you set the boundary once and the tools respect it.
Before you start#
- Where you need to be: the citation-scope form, which sits inside the template picker in the editor. (An odd home for a per-document setting — you open "New document" to change an existing document's scope — but that is where it lives today.)
- Role: Principal Investigator, Co-Investigator or Research Fellow.
- Switched on: always available.
- Also needed: nothing. To scope by collection you need a collection with papers in it.
- Costs: nothing.
What you can set#
| Setting | What it limits |
|---|---|
| Collection | Restricts the search of your library to one collection's papers |
| Sources | all · library only (never search the literature) · external only |
| Year from / to | Publication window |
| Open access only | Only papers with a freely readable version |
| Minimum impact | A journal-impact floor |
| Minimum citations | A citation-count floor |
⚠ Collection and the literature are different things#
Collection narrows your library only. It does not narrow a literature search — and this is not an oversight. A collection is a set of papers you have already collected; a paper the tool just discovered is not in any of your collections, so there is nothing for it to match against.
If your intent is "cite only what we have already screened", the setting you want is Sources → library only. That stops external results entirely. Setting a collection alone still allows new papers in from the literature.
The other filters — year, open access, impact, citations — do apply to literature results.
How to use it#
- Open the citation-scope form.
- Set the limits you want. Changes save as you make them, per document.
- Use Cite, Find papers or grounded writing as usual — they now respect the scope.
What you should see. Suggestions restricted to what you allowed. With a narrow scope, the Cite panel will more often report finding nothing — that is the setting working, not a failure.
When it doesn't work#
| What you see | What it means | What to do |
|---|---|---|
| Cite still offers papers outside my collection | Expected — collection narrows the library tier only | Set Sources → library only |
| A minimum-impact floor seems to filter nothing | A floor can only filter papers whose impact is known; where it is unknown the paper is allowed through rather than silently dropped | Combine it with a citation-count floor |
| Cite finds nothing at all now | The scope is too tight — a narrow year window plus open-access-only plus a small collection can exclude everything | Relax one limit at a time |
| Another document ignores my scope | Scope is per document, not per project | Set it on each document that needs it |
Good to know#
- It applies to writing too, not just the Cite button. Grounded suggestions respect the same scope, so autocomplete will not quietly cite something the scope excludes.
- A tighter scope makes "no sources found" more common in autocomplete. That marker is telling you the scope excluded everything, not that the feature broke.
- Fail-open on unknown values is deliberate. A paper whose impact factor is simply unknown is not excluded by an impact floor, because a floor cannot measure what it cannot see.
Related#
citations/cite-panel.md— the panel this scopesreferences/find-papers.md— literature search, which the collection does not narrowai/autocomplete.md— where "no sources found" shows up
References & discovery#
References — every source in the project, in one place#
One screen holds the project's whole reference list: the sources you added by hand, the ones you imported, the ones a literature search brought in, and the PDFs attached to them. The left rail calls it References; the page heading says Reference Manager. They are the same screen.
Why you would use it. It is where you go when the question is about the
sources rather than about the sentence you are writing — checking whether a paper
is already in the project, filing papers into a reading list, attaching a PDF, or
pulling the whole library out as a .bib file for Zotero.
If you are looking for "Library", it is gone. There used to be a separate Library entry in the project menu. It was folded into this page, and the menu entry was removed because it landed on this screen anyway. Old links ending in
/librarystill work — they redirect here. What was on that screen is now the Collections tab, described below.
Before you start#
- Where you need to be: open a project, then References in the left rail, under Writing.
- Role: any role can open the page, read every reference, open the detail panel, copy a citation, follow a reference's link and save a reference to their own My Library. Everything that changes the project's library — adding, importing, exporting, attaching PDFs, archiving, collections — needs full editing rights, which are held by Principal Investigator, Co-Investigator and Research Fellow only. A Statistician or Research Coordinator sees the list with no toolbar above it.
- Switched on: the page itself is always available. Two things on it are
switchable and both are on by default; an administrator can switch either off
in Admin Panel → Feature flags:
- literature search — controls the Discover papers and Search PubMed buttons;
- collections and reading lists — controls the Collections tab.
- Also needed: nothing to read or export. The Smart search mode needs no credentials — it ranks using a model that runs on CoPub's own server and never calls an outside AI service. The Summarize button in the detail panel is the one control on this page that does need the workspace's AI credentials configured on the server.
- Costs: the page, the filters, both search modes on Collections and the
exports are free. Discover papers and Search PubMed draw on the same
monthly literature-search allowance as Find papers in the editor — see
references/find-papers.md. Summarize spends AI credits and has its own separate monthly allowance — 10 summaries per period on the free plan.
What a reference row shows#
Each entry in the list is one source, and reads top to bottom as:
| On the row | What it is |
|---|---|
| A grey tag | The type — Article, Book, Chapter, Conference, Preprint, Dataset, Website or Other |
| Queued | A PDF you just attached is still being read; full-text search will not reach it until that finishes. It shows only in the browser tab that did the attaching — reload and the tag is gone even if the work is still running, and a collaborator never sees it at all |
| A monospaced string | The DOI, when the reference has one |
| The title | A button — click it to open the detail panel |
| A line in italics | The authors |
| A grey line | Journal, year, volume, pages — whatever is known |
| Added by … + a date | Who put it in the project and when |
To the right sit the row's actions, and three of them are open to every role — a Statistician or Coordinator can use all three:
- Cite — the clipboard icon — opens a panel with the reference written out in the project's citation style, plus a Copy citation button.
- Open URL — the arrow-out-of-a-box icon, hover-labelled, shown only when the reference carries a link — opens the paper in a new tab.
- Save to My Library — the book icon, on the Active tab only — copies the reference into your own cross-project My Library, reachable from the account menu. This one is worth knowing about: it is the single thing on this screen a read-only member can do that changes something, because what it changes is your private shelf, not the project.
Two actions need editing rights: Fetch PDF (shown only when CoPub knows of a freely readable copy and no PDF is attached yet), and Archive — or Restore, when you are on the Archived tab.
The number beside the book icon in the page heading counts the rows currently shown on Active or Archived, so it drops as you type in the search box. It does not follow the Collections tab — switch there and the number still describes the sources list behind it.
How to use it#
- Choose a tab. Active is your working library. Archived holds everything you have archived — nothing is ever deleted by archiving. Collections is the curation view.
- Narrow the list with Search title or author… and the type chips (All, Article, Book, and the rest). Clicking the chip that is already selected clears it.
- Click a title to open the detail panel on the right.
- With editing rights, use Add Reference, Import or Export in the toolbar at the top.
What you should see. A reading list ordered with the most recently added source first — not alphabetically, and not by year. On the Archived tab the order is by when each reference was archived, most recent first. An empty project instead reads "No references yet. Add one or import a BibTeX / EndNote XML file."
Adding a reference#
Four routes put a reference in by hand, all behind the toolbar and all requiring editing rights. (Discover papers and Search PubMed, in the same toolbar, are a fifth way in — they add references too, but what they add behaves differently, and that is covered at the end of this section.)
- Add Reference opens an inline form. It leads with an identifier box — "Have a DOI, ISBN or PMID? Auto-fetch the details" — so paste one, press Fetch, and the fields below fill themselves in. You can also type everything by hand; only Title is required.
- Import → Import references takes BibTeX, EndNote XML or RIS, pasted or uploaded, and can also pull your Zotero library in if you have connected it.
- The same panel takes a PDF as a new source — the field reads "Or upload a PDF as a new source (max 50 MB)" and the button is Create source from PDF. CoPub reads the file, looks up its DOI metadata when the PDF carries one, creates the reference and attaches the PDF to it.
- Import → Paste from PDF opens a separate page for pasting a reference list.
The detail is on references/adding.md. Two things are worth knowing here. Adding a
reference whose DOI is already in the project does not create a duplicate — you get
the message "This reference is already in your library" instead. And the papers
that arrive from Discover papers or Search PubMed behave differently from
the ones you add yourself: see references/provisional.md.
Collections — reading lists inside the library#
The Collections tab is the curation half of the screen. A sidebar lists your collections; All items shows everything. With editing rights you can create one with the New collection box (optionally nesting it under a parent), file a reference into it with Add to collection…, and once a collection is selected, reorder its entries with the ↑ and ↓ buttons or take an entry out again with Remove. Deleting a collection does not delete the references in it.
This view has its own search, and it is a different search from the one on Active. Here, Text matches the title, the abstract and the extracted text of any attached PDF — so you can find a paper by a phrase inside it. Smart instead ranks by meaning, which is what lets a description of what you are looking for find a paper that never uses your words.
A strip appears above the list when references are missing a PDF that CoPub knows how to fetch. It reads "N references are missing their PDFs." and carries a Review button that filters the list down to every reference without a PDF — which, as the table below explains, is not the same set the number counted. Once the filter is on, that button reads Show all and clicking it clears the filter.
Exporting your references#
Export is in the toolbar, so it is visible only with editing rights. It offers three formats:
| Choice | File | What it is for |
|---|---|---|
| Export .bib | BibTeX | LaTeX, and importing into Zotero or Mendeley |
| Export .ris | RIS | The other format every reference manager reads |
| Export .csv | Spreadsheet | Eleven columns: type, title, authors, year, journal, volume, issue, pages, DOI, PMID, URL |
.bib and .ris carry the abstract as well; .csv does not. No format carries your
collections, and none carries the attached PDF files — an export is the metadata,
not the papers.
An export always writes the whole active library. It ignores the search box, the type chips and the tab you are looking at, so filtering the screen down to eight papers and then exporting still gives you all of them. Archived references are never included.
When it doesn't work#
| What you see | What it means | What to do |
|---|---|---|
| No toolbar at all — no Add Reference, no Import, no Export | Your role does not have full editing rights | Ask a PI or Co-Investigator, or see collaboration/project-roles.md. You can still copy an individual citation with Cite |
| No Collections tab | Collections were switched off for the workspace | Ask an administrator to check Admin Panel → Feature flags |
| No Discover papers or Search PubMed | Either literature search is switched off, or your role cannot edit | Check the flag first, then the role |
| Smart search misses a paper that Text finds | Smart can only rank references CoPub has already indexed, and indexing runs in the background shortly after a reference is added. A paper added moments ago — or one that has never been re-saved since the workspace was upgraded — is not in the ranking yet | Wait and search again, or use Text, which reads the stored record directly |
| Smart search returns exactly what Text returns | The server's own search model is not running, so Smart silently falls back to plain keyword matching. This is not about AI credentials — Smart never calls an outside AI service | Nothing on this page can fix it; report it as a server problem |
| Summarize in the detail panel keeps saying "Couldn't generate a summary. Please try again." | The button renders from its flag, but the summary itself needs the workspace's AI credentials — unlike Smart search, this one really does call an outside AI service. Retrying will not help | Report it as an AI-configuration problem, not a References problem. Running out of the month's summaries produces a different message that names the limit |
| A reference I searched up yesterday is not on Active today | It was provisional and never cited | See references/provisional.md |
| Searching for a journal name, or for a word from the abstract, finds nothing | The Active search only matches titles and author names | Use the Collections tab's search, which also covers abstracts and PDF text |
| The missing-PDF strip says three, but Review lists thirty | The count is of references whose freely readable PDF CoPub knows how to fetch; Review filters to every reference without a PDF | Read the count as "three I can fetch for you", not "three without a file" |
Good to know#
- Archiving is not deleting. An archived reference keeps its record and can be brought back with Restore on the Archived tab.
- The detail panel is a reader as well as an editor. It shows every populated field — including the abstract, the citation count and a copy button for the DOI — and the up and down arrows beside its Reference details heading step through the list without closing it. Edit appears only with editing rights.
- The two forms disagree about author names, and it will catch you out. The Add Reference form asks for authors comma-separated in normal order (Jane Smith, Wei Liu) — it splits on the commas, then on the first space. The Edit form in the detail panel splits on semicolons instead, and reads a comma inside one name as family, given (Smith, J; Liu, W). So typing the Add-Reference style into the edit form does not split one author into two — it does the opposite and merges two people into one, filing "Jane Smith" as the family name and "Wei Liu" as the given name.
- Collections can list a paper that Active does not. A paper brought in by a literature search and not yet cited is hidden from Active while it is provisional, but it still appears under All items on the Collections tab.
- The "Web Importer extension" line in the import panel is not a link. It describes a browser extension that lives in CoPub's source repository; there is nothing to click and no install offered inside the product. Import from Mendeley is marked unavailable for the same kind of reason — Mendeley closed its API to new applications, so use its own BibTeX or RIS export instead.
- You can bookmark the Collections view — adding
?view=collectionsto the References URL opens it directly.
Related#
references/adding.md— the four ways to put a reference in, in detailreferences/find-papers.md— searching the literature from inside the editorreferences/provisional.md— why a discovered paper disappears if you never cite itcollaboration/project-roles.md— who has the editing rights this page keeps asking foradmin/feature-flags.md— where the two switches on this page live
Find papers — searching the literature from inside the editor#
A side panel that searches published research by keyword, without leaving your document. Results can be cited straight into the text or saved to your library.
Why you would use it. Cite answers "find me a source for this sentence." This answers "what has been published on this topic?" — the search you do before you have written the sentence.
Before you start#
- Where you need to be: in a document — open a project, then a document, then Find papers in the toolbar.
- Role: Principal Investigator, Co-Investigator or Research Fellow. Statisticians and Coordinators do not have the editing rights this needs.
- Switched on: literature search, on by default. An administrator can switch it off in Admin Panel → Feature flags; when off, the Find papers button is not shown at all.
- Also needed: nothing beyond a search term.
- Costs: each search uses one of your workspace's monthly literature searches — 25 per period on the free plan. Saving or citing a result costs nothing extra.
This search leaves CoPub. Your keywords are sent to OpenAlex, an international research catalogue, so the request leaves the Kingdom. Only the words you type are sent — never your document, your library or your project details — and every search is recorded in your workspace's audit trail.
How to use it#
- Open Find papers.
- Type a query and search.
- Narrow the results if you want to:
- Sort by relevance or by how recent the work is.
- Open access only — restrict to papers with a freely readable version.
- For each result you can:
- Cite — insert a citation at your cursor and add the paper to the project.
- Save — add it to the library without citing it now.
- See more — expand the record.
- Quote — open the paper's abstract to pull a quotation from.
What you should see. A list of real papers with titles, authors and years. Cite puts a marker in your text; Save adds the paper to References.
When it doesn't work#
| What you see | What it means | What to do |
|---|---|---|
| No Find papers button | Literature search is switched off for the workspace, or your role cannot edit | Check Feature flags, then your role |
| The panel opens but every search returns nothing | Either the query is too narrow, or the monthly search allowance is spent | Try broader terms. If several searches in a row return nothing, check AI usage for the allowance |
| "You don't have edit access." on Cite or Save | Your role lacks full editing rights | See collaboration/project-roles.md |
| A paper I saved is gone the next day | Saving cites nothing, so the paper stays provisional until it is actually used | See references/provisional.md |
| Results look unrelated to my field | The query is matched against titles and abstracts, so common words drag in noise | Add a distinguishing term — a drug name, a population, a method |
Good to know#
- Cite and Save are different. Cite puts the paper in your manuscript and keeps it permanently. Save only parks it — if you never cite it, it is tidied away after about a day.
- Open-access filtering is about the PDF, not the quality of the work: it restricts to papers with a freely readable copy, which is what makes attaching the full text possible.
- Your document's citation scope does not narrow this panel's results the way it narrows Cite. A collection is a set of papers you already have; a literature search is for papers you do not.
Related#
citations/cite-panel.md— when you have written the sentence and need a sourcereferences/provisional.md— why a saved-but-uncited paper disappearscitations/paste-doi.md— when you already know the paper
Why a paper you found sometimes disappears#
When CoPub finds a paper for you in the published literature, it is added to your project provisionally. If you never actually cite it, it is tidied away about a day later. If you do cite it, it becomes a permanent part of your library.
Why you would want to know this. It explains a behaviour that otherwise looks like a bug: a paper that appeared in your References yesterday is not there today. Nothing was lost, and nothing was deleted.
Before you start#
- Where you need to be: nothing to do — this is background behaviour.
- Role: any role can see the effect. Citing a paper, which is what keeps it, needs full editing rights.
- Switched on: always.
- Also needed: nothing.
- Costs: nothing.
What is going on#
Searching the literature has to create a real reference before it can offer you a citation — a citation needs something to point at. But importing every paper you were merely shown would fill your library with papers you never used.
So a paper found by a search is created in a provisional state:
- it is real and citable straight away;
- it does not count as part of your curated library;
- citing it keeps it, permanently and immediately;
- if nobody cites it, it is archived automatically after about 24 hours.
Nothing is deleted. Archiving hides a reference from your library list; it does not remove the record.
Which papers this applies to#
| How the paper got there | Provisional? |
|---|---|
| Found by the Cite panel's literature search | Yes — until you cite it |
| Found by Find papers | Yes — until you cite it or save it |
| Pasted as a DOI and cited | No — permanent immediately |
| Added by hand, imported from Zotero, or read in from a PDF | No — permanent immediately |
| Already in your library before the search | No — it stays exactly as it was |
That last row matters: a search that surfaces a paper you already own does not make your existing reference provisional. Papers you have collected are never put at risk by searching.
What you actually see#
- A paper offered by a literature search carries a New badge, meaning you do not have this one yet.
- Cite it, and the badge is gone next time — it is yours now.
- Ignore it, and it will not be in your list tomorrow.
When it doesn't work#
| What you see | What it means | What to do |
|---|---|---|
| A paper I saw yesterday is gone | It was provisional and never cited | Search for it again — finding it a second time costs nothing and citing it keeps it |
| I cited it and it still vanished | This should not happen; citing promotes it immediately | Check the citation is still in your text — deleting the sentence does not un-keep the reference, so the paper should still be listed. If it is genuinely missing, report it |
| My own added references disappeared | They would not — only search results are provisional | Check Archived on the References page, and the filters |
| A paper shows New but I am sure I have it | Your copy may be under a different DOI, or have none | Papers without a DOI cannot always be matched automatically — see references/find-papers.md |
Good to know#
- The tidy-up runs about once an hour, so a paper may linger a little past the 24 hours before it goes.
- Archived is not deleted. The reference can be found and restored from the References page's archived view.
- This is why browsing is safe. You can run several searches to see what is out there without committing anything to your library.
Related#
citations/cite-panel.md— where most provisional references come fromcitations/paste-doi.md— the path that is permanent from the startreferences/find-papers.md— searching the literature directly
Collaboration#
Comments — discussion pinned to the passage it is about#
A comment in CoPub is attached to the exact words it concerns. You highlight a
passage, write a comment, and those words keep a soft amber underline; clicking
that underline reopens the thread beside the sentence rather than in a list you
have to match back to the prose by eye. Replies, @-mentions, emoji reactions,
and an open/resolved state all hang off that one thread.
Why you would use it. Manuscript review. "This claim needs a citation" is useless unless the reader knows which claim — anchoring the remark to the sentence is what turns a round of comments into a work list.
Before you start#
- Where you need to be: a document open in a project. The thread list is the Comments entry in the document's … overflow menu, top right of the editor. The … button carries the thread count, so you can see there is discussion without opening anything.
- Role: anyone on the project can read every thread and reply to it — including a Statistician and a Research Coordinator, neither of whom can edit the document. Starting a thread is narrower in practice, because the only way in on screen is to highlight text in the editor: only a Principal Investigator, Co-Investigator or Research Fellow can get a thread open there. See Starting a thread needs editing rights below. Resolving and reopening: the person who started the thread, or a PI / Co-Investigator / Research Fellow.
- Switched on: always available. Commenting is not behind a feature flag, so there is nothing for an administrator to switch off in Admin Panel → Feature flags.
- Also needed: nothing. No AI credentials — nothing on this page calls a model. (AI review deposits its findings into this same panel, but that is the review feature's prerequisite, not this one's.)
- Costs: nothing. The ceilings are 500 live threads per document — open and resolved both count, archived AI threads do not — and 10,000 characters per comment (measured on the stored markup, so a very long comment trips it slightly before 10,000 typed characters).
How to use it#
- Highlight the passage in the document body.
- Click Comment on selection — the speech-bubble button in the document header. The same action appears as Comment on the small toolbar that floats over any selection.
- The Comments panel opens on the right showing a New thread block that quotes what you highlighted.
- Type into Add your comment… and press Post comment. Cancel discards the draft.
What you should see. The highlighted words gain an amber underline in the document. The thread appears in the panel with an Open badge, your name, the time, and the quoted passage above your text; the panel header changes from No comments yet on this document. to a line reading "1 open · 0 resolved".
What "anchored" actually means — and the one thing that can go wrong#
The anchor is an invisible marker written into the document body around the words you highlighted. Because it lives in the text, it travels with the text: reflow it, move the paragraph, cut and paste it elsewhere, and the thread follows.
Separately, CoPub stores a snapshot of the highlighted words (the first 500 characters) at the moment you created the thread. That snapshot is what the panel shows in the quotation above each thread, and it never changes afterwards — so if someone rewrites the sentence, the panel still shows what you were originally commenting on.
If the anchor is deleted, the thread is not. When an editor deletes or rewrites the highlighted words outright, the marker goes with them, and the thread is badged Anchor lost in orange, with the tooltip "The highlighted text was edited; the anchor is no longer in the document." The thread stays fully usable — you can still read it, reply to it, and resolve it — it simply no longer points anywhere in the prose, and the snapshot is all that is left of the original wording. This is deliberate: losing the thread would be worse than losing the pin.
⚠ Starting a thread needs editing rights#
Not because of the permission — the server lets any project member create a thread — but because of the anchor. Writing that marker into the document is a document edit, and only Principal Investigator, Co-Investigator and Research Fellow can save the document body. Since Comment on selection is the only way to open the compose box, that limit reaches the whole of thread creation, not just the highlight:
- A Statistician or Research Coordinator who selects text and clicks Comment on selection gets "Highlight some text in the document to start a comment thread." even though they did highlight text. No thread is created and no draft box opens. The message is misleading — the real reason is the role.
- The same two roles can still read every thread, reply to any open thread, react, mute, and resolve or reopen threads they started themselves. Only starting a new one is closed to them.
- If a read-only colleague needs to raise a point against a specific sentence, either they reply on an existing thread, or someone with editing rights opens the thread on that passage for them.
This is the same with co-editing on or off. If the anchor matters, quote the passage in the comment text.
The floating card#
Click any amber highlight in the document and a small card opens next to it
showing that thread: the badge, the quoted passage, every comment, and a
Reply… box. If you can resolve the thread, Resolve (or Reopen) sits
in the card too. See all comments switches to the full panel; Esc, or a
click anywhere else, closes the card. If the anchor was edited away while the
card was open, the card parks itself in the top-right corner of the window rather
than following nothing, and its Anchor lost badge explains why.
Replies, mentions, and who gets notified#
Every open thread has a Reply… box. Anyone who can read the project can use it. Replies are plain text — paragraph breaks are kept, formatting is not.
Typing @ in a comment or reply opens a list of project members; pick one and
CoPub inserts their name as plain text. If you do not use the picker, typing @
followed by a member's full name works too — the server matches it on submit,
case-insensitively (@alice finds Alice), on the whole name including
spaces, and longest name first, so @PI Alice wins over @Alice. Only people
who are active members of this project can be mentioned; an @ aimed at
anyone else stays as plain text and notifies nobody. A mention always renders
the person's current name, so later renames catch up retroactively.
Who actually receives a notification:
| Event | Who is notified |
|---|---|
| You @-mention someone | That person, as You were mentioned |
| You reply to a thread | The person who started it, plus everyone who has already replied — minus you, and minus anyone you just mentioned (no one is pinged twice) |
| A thread is resolved | The thread's author and its participants, minus whoever resolved it |
| A thread is started | Nobody. Starting a thread raises no notification unless it contains an @-mention |
| A thread is reopened | Nobody |
Two details about threads an outside reviewer started: CoPub records you — the person whose share link it was — as the thread's author, so replies on it notify you; and guests are never counted as participants, because a guest has no account to notify.
Notifications appear on the bell in the top bar. Each kind can be switched off for your own account under Notification preferences in the account area, which lists every kind with its own On/Off control.
Reactions#
Under each comment is a + 😊 button that opens a palette of five reactions: 👍 ❤️ 🎉 🤔 ✅ — a fixed set, not free text. The palette always shows all five, including ones already given; what changes is the row beside the button, where only reactions someone has actually given appear, each with its count. Your own reaction is tinted — an accent border and a filled background, rather than the plain outline every chip carries — and clicking it, in the row or in the palette, removes it. Reactions carry no notification of any kind.
Reacting needs only read access, so a Statistician or Research Coordinator can react. A guest on a share link cannot — see below.
Resolve, reopen, and mute#
Resolve closes a thread. It turns the badge green, greys its row in the panel, and removes the reply box — a resolved thread cannot be replied to at all. If you try, CoPub answers "This thread is resolved. Reopen it before replying." Reopen puts it back. Both buttons appear only if you may use them: the thread's own author, or someone with full editing rights. For everyone else there is no button and nothing to click.
Resolving does not touch the document. The highlight stays where it is, the thread stays in the panel under the Resolved filter, and no new version of the document is cut.
Mute is separate and personal. It stops notifications about one thread for
you alone; the button then reads Muted and reverses on click. Muting is a
strong instruction — it silences @-mentions in that thread too, not just
replies. Nobody else can tell you have muted anything.
Reviewers arriving on a share link#
A share link set to View + comment lets someone comment without a CoPub account. (That is the label in the dropdown where you create the link. In the list of links you have already made, the same mode is labelled just Comment.)
The first time they open the link they meet a dialog, "Tell us who's reviewing" — a name, and an email that is explicitly optional — over the whole page, with no way to dismiss it; the comment panel does not appear until they submit it. On later visits they are remembered and go straight in. Their name then appears beside their comments as " (guest)".
A guest reviewer can start threads and reply. They cannot resolve, reopen, mute, react, edit or delete anything — those controls are not rendered on the public page and there is no request they could send that would perform them. Their side panel is permanently open and has no close button.
Two things about guest threads are worth knowing before you invite an outside reviewer:
- A guest's highlight never lands in the document. The public page has no save path, so the anchor exists only in the reviewer's own browser. Every guest thread therefore shows as Anchor lost in your editor, with only the quoted snapshot to locate it. Ask reviewers to quote enough context.
- In your editor, a guest's comment is attributed to "Unknown author" — their name is only rendered on the public page they wrote it from. It exports as "Guest".
A View only link is completely sealed: no panel, no replies, and the amber highlights are stripped from the text before it is served, so a read-only recipient cannot even see where your team has been arguing.
Reading a long panel#
The panel filters by All / Open / Resolved and sorts Oldest first / Newest first. The sort is remembered for your account; the filter is not, and resets to All on the next page load.
The thread list is keyboard-navigable as a single tab stop: ↑/↓ or j/k
move between threads, Home/End jump to the ends, and Enter puts the cursor
in the focused thread's reply box. Those keys are ignored while you are typing.
The panel updates live. A colleague's reply, resolution or deletion appears without a refresh for anyone with that document open.
When it doesn't work#
| What you see | What it means | What to do |
|---|---|---|
| "Highlight some text in the document to start a comment thread." although you did highlight text, and you are a Statistician or Research Coordinator | The message is misleading. Your role cannot write the anchor into the document, so no thread can be started from a selection | Reply on an existing thread instead, or ask a PI / Co-Investigator / Research Fellow to open the thread on that passage |
| The same message while you are in Preview | The preview has no editable body for the anchor to attach to, so the button cannot see your selection | Switch back to Edit and highlight again |
| The same message in Edit mode with editing rights | The selection started or ended outside the document body — a title, a toolbar, the panel itself | Select strictly inside the page canvas |
| A thread is badged Anchor lost | The highlighted words were deleted or rewritten | Read the quoted snapshot; the thread still works. Resolve it if it is stale |
| Every thread from an outside reviewer is Anchor lost | Expected — the public page cannot save anchors into your document | Ask reviewers to quote the passage in the comment text |
| A reviewer's comment says Unknown author | Guest names are only rendered on the public share page | Open the share link yourself to see who wrote it — the Word export labels every guest comment "Guest", not by name |
| No Resolve button on a thread | You are neither its author nor a PI / Co-Investigator / Research Fellow | Ask one of them, or ask the thread's author |
| "You can't resolve this thread." | The same gate, hit via a stale page | Reload; the button should not have been there |
| No reply box on a thread | It is resolved | Reopen it first — if you are allowed to |
| "This document has reached the comment-thread limit." | 500 threads on one document | Resolve or clear old threads, or split the document |
| "Couldn't post that comment." | Almost always the 10,000-character ceiling on a single comment | Shorten it, or split it across replies |
| No Edit or Delete under someone else's comment | Those two buttons are only ever drawn for the comment's own author | Ask the author. Editing is genuinely author-only everywhere; deleting is only button-only — a PI or Co-Investigator holds the permission and can delete through the API |
Good to know#
- Comments ride the Word export. Unresolved threads leave as real Word comments on the right passage, reviewable in Word's review pane — capped at the 200 oldest. Resolved threads are dropped. Threads whose anchor was lost are not silently discarded; they are collected into an Unresolved comments (anchor lost) block at the end of the document. Replies are flattened into the one Word comment, each line prefixed with its author.
- Editing your own comment has no time limit, and it is never silent — an italic · edited marker appears next to the timestamp permanently. Only the author sees the Edit and Delete buttons.
- Deleting is soft. The comment becomes "(comment deleted)" in place, so the shape of the conversation survives. In the panel the Delete button is drawn for the comment's author and nobody else — so no button in the editor will remove a colleague's comment. The permission, though, is wider than the button: a Principal Investigator or Co-Investigator may delete anyone's comment, and the REST API exposes that. Treat "no one else can delete my comment" as true of the editor screen, not of the account.
- AI review threads share this panel. They arrive carrying an AI · Major or AI · Minor chip and are resolved and reopened exactly like human threads. Re-running a review archives the AI threads you left open but keeps the ones you resolved, so your triage decisions survive.
- Comments are per document, not per project, and resolving one never edits the manuscript or cuts a new version.
- The highlight does not print. It is cleared in print and export, so a commented draft prints clean.
Related#
collaboration/project-roles.md— the five roles, and why a Statistician can reply but not open a threadsharing/share-links.md— the three link modes, and what a guest reviewer can reachai/ai-review.md— the other producer of threads in this panel
Sharing & publishing#
Share links — giving access to someone who is not a member#
A share link lets you hand one document to someone outside the project — a supervisor, a statistician at another centre, a journal contact — without adding them to the project first.
Why you would use it. You want one person to read or comment on one document. Adding them as a project member would give them the whole project; a share link gives them exactly the document and exactly the access you chose.
Before you start#
- Where you need to be: open the document, then Share.
- Role: you need editing rights on the project — PI, Co-Investigator or Research Fellow.
- Switched on: always available.
- Also needed: nothing. The recipient does not need a CoPub account for a view or comment link.
- Costs: nothing.
The three access levels#
| Access | What the recipient can do | Do they need an account? |
|---|---|---|
| View only | Read the document. Nothing else. | No |
| View + comment | Read it, and leave comments and replies | No |
| Can edit | Read, comment and edit — by joining the project | Yes |
⚠ "Can edit" is an invitation to join the project, not just a stronger link. When someone opens an edit link they are asked to sign in or sign up, and accepting adds them to the project as a Research Fellow — a real member with full editing rights across the project, who then appears under Members like anyone else. From that point their access comes from their membership, so revoking the link no longer removes it. Treat an edit link as an open invitation: send it to one person, and set an expiry.
How to use it#
- Open the document and click Share.
- Under New link, choose an Access level.
- Optionally set an Expires date and time — shown in your own local time. Leave it blank and the link works until you revoke it.
- Click Create link.
- Copy the link and send it.
What you should see. The new link appears in the list with its access level and expiry. Anyone opening it sees the document at that access level.
When it doesn't work#
| What you see | What it means | What to do |
|---|---|---|
| No Share button | Your role does not have editing rights | See collaboration/project-roles.md |
| The recipient sees "not found" | The link was revoked, or it expired | Create a new one |
| The recipient is asked to sign in | It is an edit link | Expected — edit links require an account because accepting makes them a project member |
| "Too many attempts — try again in a few minutes." | Repeated failed attempts on an edit link are rate-limited | Wait a few minutes, and check you sent the whole link |
| Revoking did not remove someone's access | They had already claimed an edit link and are now a project member | Remove them under Members on the project Overview |
Good to know#
- Expired links revoke themselves. A link past its expiry stops working without anyone having to act.
- Revoking is immediate and applies to everyone holding that link.
- A comment link does not let someone edit the text — comments sit alongside the document.
- You can have several links on one document with different access levels and expiries, which is how you give a reviewer comment access and a co-author edit access from the same page.
Related#
collaboration/project-roles.md— what a Research Fellow can do once they joinsharing/publishing.md— publishing a read-only version for a wider audience
Exporting a document#
Downloading your manuscript as a file: a Word document, a PDF, or a LaTeX bundle. Three formats, one menu, and three genuinely different results — they are not the same document in three wrappers.
Why you would use it. A journal wants a .docx upload, a co-author who does
not use CoPub wants something to read on a plane, and a physics or maths journal
wants LaTeX source. For Word and PDF, the export is also the moment your citations
stop being CoPub's live markers and become finished, formatted text. LaTeX is the
exception, and the rest of this page keeps saying so.
Before you start#
- Where you need to be: the editor, with the document open. The export entries live under the … button in the document header (its tooltip reads More), then Export.
- Role: any of the five project roles. Export checks read access, not editing rights, so a Research Coordinator and a Statistician can export exactly what a Principal Investigator can. This is one of the few document actions where that is true.
- Switched on: always available. There is no feature flag for export — nothing in the admin panel can switch it off.
- Also needed: nothing. Export needs no AI credentials, which makes it one of the surfaces that keeps working when the workspace's AI configuration is missing or broken. One server-side component does matter, and it is described under When it doesn't work: the headless browser the server uses to render. PDF cannot be produced without it at all, and Word needs it only to turn equations into pictures.
- Costs: nothing. No AI credits are spent, and there is no monthly export allowance. Every plan tier exports an unlimited number of pages and every tier includes the bibliography.
The three formats#
| Menu entry | You get | Best for |
|---|---|---|
| Export to Word | one .docx file |
journal submission, and any co-author who tracks changes in Word |
| Export to PDF | one .pdf file |
reading and circulating a fixed version |
| Export to LaTeX (.tex + .bib) | a .zip holding manuscript.tex and references.bib |
journals that want LaTeX source |
Word and PDF are built from the same prepared document: headings numbered, a table of contents, figures and tables numbered, cross-references resolved, citations rewritten into your chosen style, and a References list appended. LaTeX is built from a different starting point and is described separately below — if you skim only one thing on this page, make it that.
How to use it#
- Open the document in the editor.
- Click the … button in the document header.
- Click Export — the row with the chevron. The submenu expands in place rather than flying out sideways, so it works the same on a phone as on a desktop.
- Click Export to Word, Export to PDF, or Export to LaTeX (.tex + .bib).
What you should see. The browser downloads a file and you stay in the editor —
the page does not navigate away. The filename is your document title with spaces
turned into underscores; the LaTeX bundle adds _latex before .zip.
Two things may appear above the export entries first. An amber note — "AI helped write this document and it carries no AI-use statement. Journals following ICMJE and COPE expect one." with Review & add and Not this time — shows only when CoPub's own record says AI touched this document and the document does not already carry a disclosure. It does not block the export; the entries below it stay clickable. Separately, a thin amber strip below the header may ask Review before exporting? with Run review and Dismiss — that is a suggestion, not a gate. It needs three things at once: the workspace has AI review switched on, you are a member who can edit, and the document has been changed since its last review.
What comes across, and what does not#
Everything in the body travels. Headings, paragraphs, bold/italic/underline/ strikethrough, lists, links, horizontal rules, tables, figures with their captions, footnotes, equations, the author and affiliation block, the table of contents, and the References list. Text never goes missing. Three things arrive in worse shape than they left — the Word file's contents list, a WebP figure, and a superscript citation marker in Word — and each is spelled out below.
Where the three formats differ:
| Word | LaTeX | ||
|---|---|---|---|
| Heading numbers | yes | yes | no — but article numbers your sections itself when you build |
| Table of contents | present but printed backwards — see below | yes | no — add \tableofcontents yourself |
| Figure/table numbers, cross-references | yes | yes | no — \caption numbers figures, but a text cross-reference does not resolve |
| In-text citations in your journal style | yes — but a numbered style's superscript prints level with the text, not raised | yes | no — \cite{} keys |
| Bibliography | a References section | a References section | a separate references.bib |
| Footnotes | real Word footnotes, per page | a Footnotes section at the end | real LaTeX \footnote{} |
| Figures | embedded — PNG, JPEG and GIF only | embedded — PNG, JPEG and GIF only | not embedded — a boxed placeholder inside a figure environment, with the image address left in a comment |
| Unresolved comment threads | included as real Word comments | not included | not included |
| The document title | in the file's properties, not on the page | not shown | on the page, via \maketitle |
| Page numbers | none — the file has no header or footer | none | yes, once you build it — article numbers pages by default |
Some of those deserve a sentence.
The Word file's table of contents is in reverse order. This is a live defect, not a design choice. The entries are all there, correctly numbered and correctly titled, but they print last-to-first, and the word Contents prints after them instead of above. Everything else in the document — including the heading numbers the contents list refers to — is in the right order. Until it is fixed, delete that block after opening the file, or use Word's own References → Table of Contents, which builds one from your headings. The PDF is unaffected, and LaTeX does not emit a contents list at all.
LaTeX is deliberately raw. It is exported from your document as you wrote it,
not from the prepared version, because LaTeX is supposed to do the preparing. Your
citations arrive as \cite{...} keyed to the entries in references.bib, and
\bibliographystyle{plain} plus \bibliography{references} are added just before
\end{document} — but only if the document actually cites something that is in
this project's library. Cite nothing and you get a manuscript.tex with no
bibliography commands at all, and an empty references.bib beside it.
The consequence to plan for: the heading numbers and the contents list you see in
CoPub are absent from manuscript.tex. You are not left without numbering —
\documentclass{article} numbers \section and friends when you build — but the
numbers are LaTeX's, not the ones on your screen, and there is no
\tableofcontents line, so add one if you want it. A cross-reference to "Table 2"
arrives as whatever text is in it rather than a resolved number. A citation whose
source is no longer in the project's library is written out as its visible text
instead of a \cite{}, so your build does not break on it.
Comments are a Word-only feature, and only the open ones. Unresolved comment threads become native Word comments anchored to the same words you highlighted, reviewable in Word's review pane. Resolved and archived threads are left out on purpose — the export is a hand-off, and settled discussion is noise. A thread whose anchoring text has since been edited away is not dropped; it is collected into an "anchor lost" block at the end. At most 200 threads are carried, oldest first.
Figures must live in CoPub, and be a PNG, a JPEG or a GIF. Two separate
things can cost you a picture. An image you linked from another website is not
fetched at all — the export only trusts your workspace's own storage. And an
image you uploaded is embedded only if it is a PNG, a JPEG or a GIF: the
document's image picker also accepts WebP, which displays perfectly in the
editor and then cannot be embedded in either file. Either way the failure looks
the same — in Word you get the caption without the picture, in the PDF the
picture is simply absent. If a figure vanishes from an export and you did upload
it, check whether it is a .webp and re-save it as PNG.
Equations are rendered as pictures for Word by the same server-side renderer the PDF uses, up to 100 distinct equations per export. Identical equations count once. Past the cap, or if the renderer misses one, the equation appears in Word as its raw LaTeX source so it is at least readable and fixable.
When it doesn't work#
| What you see | What it means | What to do |
|---|---|---|
| There is no … button, or no Export in it | No document is open — the header belongs to the active document | Open a document from the sidebar first |
| Export to Word or Export to LaTeX lands on a Not found page | Two very different causes share one answer here: you no longer have access to this project, or the file could not be built. Hiding the first behind "Not found" is deliberate; the second falls into the same response, which is unhelpful and worth knowing | Reload the editor. If the document still opens, it was a build failure — try again, and report it if it repeats |
| Export to PDF returns you to the editor with PDF export failed. Please try again. | PDF is rendered by a headless browser on the server. That render timed out, ran out of memory, or the renderer is not running | Retry once. LaTeX does not touch that renderer at all, and Word only uses it for equations, so both still produce a file |
| Everything is switched on, my role is right, Word exports fine — and PDF still fails | This is the expected shape of a renderer outage. The renderer runs one job at a time and is deliberately walled off from the rest of the server, so its failures cannot take the editor down with them | Export to Word instead, and tell an administrator the renderer is down. Expect your equations to come through as raw LaTeX until it is back — Word borrows the same renderer for those. No setting on your side will fix it |
| A figure is missing from the PDF, or Word shows only its caption | Either the image is hosted outside CoPub and was refused, or it is a WebP, which cannot be embedded in either format | Upload the image into the document rather than linking to it, and save it as PNG or JPEG |
| Equations appear as raw LaTeX in the Word file | The equation renderer missed them, the renderer is down, or the document has more than 100 distinct equations | Retry; if it persists, it is the same renderer the PDF path uses, and the PDF will be failing too |
| The Word file's contents list is upside down | A known defect in the Word builder — it reverses that one block | Delete it and rebuild it in Word, or ignore it; nothing else in the file is affected |
| The References list is followed by "N citations in this document could not be resolved" | Those cite markers point at references that are not in this project's library — most often because the document was copied from another project, which does not bring its references along | Re-attach each one with the citation picker, or add the reference to this project |
The file downloads as document.docx (or _latex.zip) |
Filenames keep only Latin letters, digits, spaces, hyphens and underscores, so an Arabic or Chinese title reduces to nothing and the name falls back | Rename the file after downloading; the document itself is unaffected |
| This document is N pages and your plan exports up to M. Split it or upgrade to export the whole document. | A per-plan page ceiling refused the export. It is counted on the finished PDF, so only Export to PDF can ever produce this — Word and LaTeX are never page-limited | You should not be able to see this today: none of the three plan tiers has a page limit set. If it appears, someone has set one in the server's configuration; it is not a switch in the admin panel |
Good to know#
- The export reads the saved document, not what is on your screen. The
download is an ordinary link, so anything typed in the last moment before
clicking may not be in the file. With co-editing off the editor sends a change still
waiting to be saved when you start an export, and otherwise saves about four seconds
after you stop typing; with co-editing on a copy is written about four seconds after
an editing burst settles (see
editor/editor-overview.md). Pausing briefly before you export is enough. - Word gets your title in its file properties, not on its first page. Open File → Info in Word and you will find it — sourced from the document's first heading, falling back to the document's name. The Author field is filled with the names of every project member, which is worth checking before a blinded submission.
- The unresolved-citations notice is written in English even when the rest of CoPub is in Arabic. That is a known gap in that one block, not a sign that something is set wrong.
- The table of contents and heading numbers only appear when the document has
at least two headings. A short note with one heading exports without a
surprise
1in front of it. The numbers themselves have no trailing dot — a top-level heading reads1 Methods, a nested one1.1 Participants. - A numbered citation style loses its raise in Word. The four numbered
styles — IEEE, Vancouver, AMA and Nature — put the number in superscript, so
synovitis⁷on screen and in the PDF becomessynovitis7in the.docx. The number is right and still jumps to the correct entry in the References list when clicked; it just sits level with the text. The author–date styles (APA, Harvard, Chicago, MLA) are unaffected — nothing about(Smith, 2024)is raised. - Every export is recorded. One audit entry is written per download, naming the document, the format and the file size. Copying the document to the clipboard is recorded the same way.
- There is a fourth way out that is not on this menu: the clipboard button in
the document header (Copy document to clipboard) copies the prepared
document — journal-formatted citations and the References list, not the editor's
placeholder labels — so pasting into Word or Google Docs gives you finished
text. See
sharing/copy-to-clipboard.md. - A share link is not an export. Someone opening a shared document in their browser has no export menu at all; if they need a file, you send them one.
Related#
sharing/share-links.md— giving someone the document without sending a filesharing/copy-to-clipboard.md— the paste-into-Word pathcitations/styles-and-bibliography.md— which style the References list usesreferences/export.md— exporting the reference library itself, in BibTeX/RIS/CSVcollaboration/comments.md— the threads that ride along in the Word filecollaboration/project-roles.md— the five roles, and why export needs none of their editing rights
Administration#
Feature flags — switching a capability off for a workspace#
Every CoPub capability has a switch. This page is where an administrator turns one off for a whole workspace, and where you check what a workspace actually has.
Why you would use it. A researcher reports that a button is missing. This page tells you in one glance whether someone switched that capability off — and, just as often, that they did not, and the real problem is elsewhere.
Before you start#
- Where you need to be: the Admin Panel — a separate application from the main app, with its own sign-in. Go to Feature flags, then choose the workspace.
- Role: workspace administrator. Ordinary project roles cannot reach this page.
- Switched on: always available.
- Also needed: nothing.
- Costs: nothing.
Everything is on by default#
Every flag defaults to on. A new workspace has the full product available with nothing to configure, and nobody has to request access to a feature.
That makes this page an off switch, not an on switch. If a capability is missing for a workspace, someone set an explicit Disable here — it did not fail to be switched on.
The three states#
| State | What it means |
|---|---|
| Default | No override. The workspace follows CoPub's built-in setting, which is on. |
| Enable / Disable | An explicit override for this workspace only. An override always beats the default. |
| Clear | Removes the override and lets the default apply again. |
The Effective badge shows the true current answer. Read it whenever you are unsure — it accounts for the override and the default together.
How to use it#
- Open the Admin Panel and sign in.
- Go to Feature flags and select the workspace.
- Find the capability.
- Choose Disable to switch it off for this workspace, or Clear to return it to the default.
What you should see. The Effective badge updates to match. Users in that workspace see the change on their next page load — no deploy, no restart.
⚠ A green Effective badge does not mean the feature works#
This is the most common wasted round-trip between a researcher and an administrator, and it is worth understanding before you reply to one.
A flag controls whether a control is visible. The AI capabilities additionally need the workspace's AI service credentials to be configured. The two are independent:
| Flag | Credentials | What the researcher experiences |
|---|---|---|
| On | Present | Works |
| On | Missing | Buttons are all there and every AI action fails |
| Off | Either | The buttons are not rendered at all |
So if a researcher reports that AI "does nothing" and the badge is green, do not tell them it is fixed. The signature of the credentials case is that the controls are present and the actions error; the signature of the flag case is that the controls are absent. Missing credentials are an operator fix on the deployment, not something this page can resolve.
When it doesn't work#
| What you see | What it means | What to do |
|---|---|---|
| The researcher still sees the old state | They have not reloaded | Ask them to reload — no deploy is needed |
| A capability is off and you did not switch it off | Someone else set an override, or it was set on a different workspace | Check you have the right workspace selected, and read Effective |
| Everything is on and AI still fails | Credentials, not flags | See the section above |
Good to know#
- Switching a flag off is instantaneous and reversible. It is a single setting with no deploy, which makes it a usable kill switch if a capability misbehaves.
- Overrides are per workspace. Switching something off for one organization does not affect any other.
- This page decides the phrases used elsewhere in the guide. Where the guide says "an administrator can switch this off", this is the page it means.
Related#
collaboration/project-roles.md— project roles, which are a separate thing from workspace administration