CoPub — Complete User Guide

Research OS for medical & scientific research teams — every feature, explained.

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#

  1. Getting Started — accounts, sign-in, the dashboard, and creating projects
  2. The Manuscript Editor — writing, formatting, co-editing, versions, and exporting
  3. Citations & Reference Styles — inserting citations and the eight built-in styles
  4. References & Importing — building your reference list from anywhere
  5. Research Library & My Library — organising papers and reading with AI
  6. Tasks & Files — the project board and shared file storage
  7. Communication — Team Chat — messages, channels, voice notes, and search
  8. Meeting Minutes — structured minutes with AI transcription
  9. Smart Lab Notebook — capture ideas, images, links, and voice with AI
  10. Comments & Sharing Documents — feedback, external share links, and publishing a snapshot
  11. Learning hub — built-in tutorials that walk you through the platform
  12. The AI Assistant Suite — every AI feature, and how usage works
  13. Your Account, Billing & Settings — profile, security, plans, and language
  14. 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)

Sharing & publishing (Comments & Sharing Documents → Publishing a document)

Learning (Learning hub)


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 chat (The AI Assistant Suite)

Reviews (The AI Assistant Suite → Review)

References & library (References & Importing, Research Library & My Library, Citations & Reference Styles)

Comments & collaboration (Comments & Sharing Documents)

Account & app (Your Account, Billing & Settings)


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.

  1. Go to the Create your account page (the sign-up screen).
  2. Fill in the Email field — this is required and becomes your sign-in name.
  3. Optionally add your Full name — you can leave this blank and set it later.
  4. 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.
  5. 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.

For security, a brand-new email-and-password account has to confirm it owns the address before it can sign in.

  1. Right after you sign up, CoPub emails you a verification link.
  2. Open that email and click the link. This confirms your address and unlocks sign-in.
  3. 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#

  1. Open the Sign in page.
  2. Enter your Email and Password.
  3. 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.

  1. On the sign-in page, click Forgot password?
  2. Enter your Email and click Send reset link.
  3. 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.

  1. Type your New password — the same rules apply (12+ characters, with a lowercase letter, an uppercase letter, and a digit).
  2. 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#

  1. Click New project (from the dashboard's top-right button, or the empty-state prompt).
  2. 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.
  3. 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:

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:

  1. Open the project's Settings → Members page.
  2. In the Invite a member box, enter their email address.
  3. 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.)
  4. Click Invite.

What happens next depends on the person:

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):

  1. In the Transfer principal investigator role box, choose the member to promote.
  2. Type the project's title exactly to confirm.
  3. 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:

  1. Write 50+ words in a document
  2. Add a reference
  3. Organize a collection
  4. Try an AI feature (if AI is enabled for your workspace)
  5. 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).

  1. 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.
  2. 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.
  3. 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#

  1. 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.

  2. 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.

  3. 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
  4. 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:

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:

  1. Rename — click the title or the rename control, type a new title, and confirm. Titles can't be blank.
  2. Duplicate — makes a full copy of the current document and opens it, so you can branch a draft without losing the original.
  3. 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.
  4. Restore — open the Archived tab in the sidebar and click Restore on any row to bring the document back to your active list.
  5. 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:

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.

  1. Type / on an empty line (or at the start of a line).
  2. Keep typing to filter — for example /quote or /table.
  3. 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#

Tables#

  1. Click Table on the toolbar (under More tools when the toolbar is folded).
  2. 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.
  3. Click Insert table. The first row is a header row. (Typing /table drops 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.

  1. Click Figure on the toolbar (or type /figure).
  2. Fill in:
    • Image URL — a link starting with http:// or https://.
    • Alt text — a short description read aloud by screen readers.
    • Caption — e.g. "Survival curves by treatment arm."
  3. 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.

  1. 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.
  2. Type the LaTeX — for example E = mc^2.
  3. 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#

  1. Click Footnote on the toolbar (or type /footnote).
  2. Type the footnote text.
  3. 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.

  1. Click Cross-reference on the toolbar (under More tools when the toolbar is folded).
  2. Pick what you're pointing to — the picker is grouped into Figures, Sections, Tables, Equations and Footnotes, listing each item with a short preview.
  3. 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:

Version history and restore#

Every save is captured, so you can always look back or roll back.

  1. Click History in the editor's top bar (anyone who can read the document can open it).
  2. A timeline opens on the right, newest first — each entry shows who edited it and when.
  3. Click any entry to preview that version.
  4. 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.
  5. 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:

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.

  1. 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.
  2. 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.
  3. 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 .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.

  1. In the document body, type @ at the start of a line or after a space.
  2. 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).
  3. Keep typing to filter — the letters after @ search across title, authors, and year. The first match is highlighted automatically.
  4. Press Enter to insert the highlighted reference, or use ↑ / ↓ to move the highlight first. You can also click a row with the mouse.
  5. 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.

  1. Click Cite on the editor toolbar (keyboard shortcut Ctrl + Shift + C). You can also type / for the slash menu and choose Cite a reference.
  2. 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.
  3. Type in the filter box to narrow the list; a "No references match" line appears if nothing fits.
  4. 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)

Note: Each style shows the page locator its own way — APA/Harvard use , p. 23, Chicago uses , 23, MLA uses 23. You just type the number; CoPub formats it to match the chosen style.

Reading and checking your citations#

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.

  1. 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.)
  2. The Citation style window opens with the list of styles on the left and a live Preview on the right.
  3. Toggle the preview between Bibliography and In-text to see how a sample reference will look in each style.
  4. 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):

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.

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:

  1. Select the sentence or paragraph you want to support.
  2. Choose Suggest citations (the Cite action on the floating selection toolbar).
  3. 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#

  1. Use the Active and Archived tabs to switch between your current library and references you've retired.
  2. Type in the Search title or author… box to filter the list. It searches reference titles and author names, and updates as you type.
  3. 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:

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.

  1. To close the drawer, click the ✕, or click anywhere outside the panel.
  2. If you have editing access, an Edit button appears at the bottom.

Adding a reference by hand#

  1. Click Add Reference. A New reference form opens.
  2. Fill in the fields. Title is the only required one; Type, Authors, Year, Journal, Volume, Pages, DOI and URL are all optional.
  3. 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.
  4. Click Save reference.

A few gentle rules the form enforces:

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.

  1. Click Add Reference to open the form.
  2. 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 full https://doi.org/… link.
  3. Click Fetch. CoPub looks the paper up and fills in the title, authors, year, journal, and more for you.
  4. 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.

  1. Click Import. The Import references panel opens.
  2. 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
  1. 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.
  2. 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:

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.

  1. From the Reference Manager, click Paste from PDF. This opens the Import references from text page.
  2. 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"
  1. 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.
  2. 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.
  3. 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):

  1. Click Search PubMed.
  2. Type a query — plain words like covid-19 anosmia 2024, or a specific DOI.
  3. Click Search. Results show the PMID, DOI, title, authors, and journal.
  4. 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):

  1. Click Discover papers.
  2. Type your search and click Search.
  3. 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.
  4. 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):

  1. Go to Account → Connections.
  2. In the Zotero card, paste an API key generated from zotero.org/settings/keys and 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:

  1. In a project, open the Reference Manager and click Import.
  2. 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.)
  3. 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#

  1. Open a reference by clicking its title, then click Edit (editors only).
  2. Update any field: Type, Title (required), Authors, Year, Journal, Volume, Issue, Pages, DOI, URL, and Abstract.
  3. 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.
  4. 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.

  1. On any reference card (in the Active tab), click the Archive icon and confirm the prompt.
  2. To see archived references, switch to the Archived tab. Each shows when it was archived.
  3. 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:

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:

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.

  1. Click the pencil icon on the entry (its tooltip reads "Notes & tags").
  2. In the panel that opens, type free-form notes in the large box.
  3. 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.
  4. 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:

  1. On an entry with no PDF, click Upload PDF.
  2. Choose a PDF file, up to 50 MB.
  3. 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.

  1. 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.
  2. Pick a priority from the dropdown — Medium (pre-selected), High, or Low.
  3. Optionally choose a due date with the date picker.
  4. 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.)
  5. 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:

Who can change a task's status or tick it off:

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.

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.

  1. In List view, click the small archive (box) icon at the far right of the task row.
  2. 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:

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:

  1. Drag and drop — drag one or more files from your computer onto the dashed box, or
  2. 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

  1. Click the Download button on the file's row.
  2. 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.

  1. Click the archive icon on the file's row.
  2. 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:

  1. 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.
  2. 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#

  1. Select a conversation from the rail.
  2. Click into the message box at the bottom — it says Write a message….
  3. Type your message. Press Enter for a new line, or use ⌘/Ctrl + Enter to send.
  4. 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.

  1. Hover or look under the message you want to answer and click Reply.
  2. 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.)
  3. 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.

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:

  1. Click the paperclip icon to the left of the message box (Attach files).
  2. Pick up to 3 files — each up to 25 MB.
  3. Your chosen files appear as chips above the message box, each showing its name and size. Remove one before sending with its ✕.
  4. 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:

  1. 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.
  2. The message row turns into a recording bar: a red pulsing dot, a running timer (0:00), and Recording….
  3. 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:

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.

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).

  1. Start typing — results appear live as you type.
  2. Each result shows who wrote it, when, and a short snippet around your search term.
  3. 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):

  1. In the rail, click the + next to the Project heading.
  2. Type a Channel name (up to 200 characters) and press Enter.
  3. The new channel opens right away and appears in your rail with a # in front of its name.

To archive a channel:

  1. Open the channel and click Archive in its header.
  2. 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#

  1. In the rail, click the + next to the Direct messages heading.
  2. 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.
  3. 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#

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#

  1. Open your project and go to its Meetings section.
  2. At the top you'll see the heading Meetings with a short reminder that minutes are "searchable by keyword, date, and attendee."
  3. On the right is the New meeting button (visible if you're able to contribute to the project).
  4. 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#

  1. Click New meeting. A form opens directly on the page.
  2. 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).
  1. 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.
  2. 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).

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:

  1. 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.
  2. 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

  1. Expand the meeting.
  2. In the Add an action item… box at the bottom of the action-items list, type the follow-up (up to 2,000 characters).
  3. Press Enter or click Add. It appears in the list immediately.

Removing an action item

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.

  1. Expand the meeting and find the action item under Action items.
  2. Click Create task next to it.
  3. 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

  1. Expand the meeting and find the Recording section.
  2. Choose an audio file, then click Upload & transcribe.
  3. 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

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:

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.

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#

  1. Click Text Note.
  2. Type a Title and/or a Note. (Formatting like Markdown is supported in the note body.)
  3. Add Tags if you like.
  4. 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#

  1. Click Insert Picture.
  2. 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.
  3. Optionally add a Caption (this becomes the entry's title) and a Description.
  4. 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.

  1. Click Insert Link.
  2. In URL or DOI, paste the web address or DOI you want to keep. It must be a normal http:// or https:// web address.
  3. 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."
  4. 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#

  1. Click Voice Note.
  2. 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."
  3. 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.

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).

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#

  1. Open the picture card.
  2. Press Add images.
  3. An uploader appears — choose one or more files (same formats and limits as above).
  4. 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.

  1. Press ✦ Ask AI to open the panel ("How can I help with this?").
  2. 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.
  1. 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#

  1. On the Mine tab, open (or find) the entry and press Edit on its row.
  2. The same capture window reopens, pre-filled with your existing content.
  3. 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

  1. Press Share on a private entry.
  2. 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)

  1. Press Delete on a private entry.
  2. 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)

  1. Press Archive on a shared entry.
  2. It moves to the Archived tab (the team's shared snapshot stays put). You'll see "Entry archived."

Restore

  1. Go to the Archived tab.
  2. 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.

  1. Go to the Team tab and find the entry you shared.
  2. If you're still within 24 hours of sharing, an Unshare button appears (only on entries you shared).
  3. 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.

  1. In the document, highlight the words, sentence, or paragraph you want to comment on.
  2. 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.)
  3. 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.
  4. Type your comment in the Add your comment… box.
  5. 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:

  1. Start typing @ followed by a name.
  2. A small list of your project's active members appears — pick one.
  3. 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:

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:

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:

  1. In the thread header, click Resolve.
  2. 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:

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:

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#


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.)

  1. In the editor toolbar, click the Share (chain-link) button. The Share document panel slides in from the right.

  2. 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.
  3. 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.

  4. 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.

Each entry in Active links shows you:

To cut off access at any time:

  1. Find the link in Active links.
  2. 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.

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."

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.

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.

  1. 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)").
  2. 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.
  3. 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):

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.

  1. In the editor, open the Share modal and switch to the Publish tab.
  2. 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.
  3. 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.
  4. 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:

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:

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:

  1. An AI credits chip — hover it to see "AI credits remaining this period."
  2. 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.

  1. Click the AI chat button in the editor toolbar to open the chat panel.
  2. Type your question in the box at the bottom — placeholder "Ask about this document…"
  3. Press Send (or Enter).
  4. While it works you'll see "Thinking…"; the answer then appears in the thread.
  5. 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.
  6. 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.

  1. 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.")
  2. 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."
  3. Click Run research.
  4. While it runs you'll see "Researching — planning, searching, writing…"
  5. 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.

  1. 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:


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.

  1. Click Section prompts in the toolbar to open its panel.
  2. 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.)
  3. Type a one-line brief per section — e.g. what the Methods section should include.
  4. 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:

  1. Review the proposed rewrite.
  2. 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.

  1. Click AI outline in the toolbar.
  2. Provide the topic.
  3. The assistant returns a logically ordered set of main sections and subsections (typically four to ten main sections).
  4. 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.

  1. Select the sentence or passage you want to support.
  2. Click Cite (or Suggest citations).
  3. A Suggested citations panel lists the most relevant references from your library, most relevant first.
  4. 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.

  1. Open the AI review panel (the lens cards).
  2. 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."
  3. 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.

  1. In the Tone of voice panel, pick a target tone from the dropdown.
  2. Click Check tone.
  3. 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.

  1. Open a reference that has a PDF attached. (If none is attached, you'll be prompted to attach one from the library.)
  2. In the question box — "Ask about this PDF…" — type your question.
  3. Click Ask. The helper text notes: "answers are grounded in its text."
  4. 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).

  1. In a notebook entry, click Add images / Upload Image and choose your files (PNG, JPEG, GIF, or WEBP; up to 10 MB each).
  2. Add an optional Caption.
  3. Click Analyse on the image (Re-analyse to run it again). You'll see "Analysing…"
  4. 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).


Meeting minutes#

In Meetings, upload a recording and CoPub transcribes it, then drafts structured minutes for you.

  1. On a meeting, click Upload & transcribe and choose the recording.
  2. 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.

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:

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:


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.

  1. Look at the top-right corner of any screen for your account menu (the options button).
  2. 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.
  3. 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/connections directly.


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

  1. If you're on the edit form, type your Full name in the box (for example, Jane Smith).
  2. 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:

  1. The page lists the provider(s) your account signs in with.
  2. Open Switch to email + password sign-in.
  3. Enter a New password and Confirm new password.
  4. 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).

  1. Enter a New email address and your Current password.
  2. Click Change email.
  3. 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.

  1. Enter your Current password.
  2. Enter a New password and Confirm new password.
  3. 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).

  1. Go to zotero.org/settings/keys and create an API key.
  2. On the Zotero card, paste the key into the box.
  3. 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.

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

The actions you can take

  1. 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.)
  2. 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.
  3. 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.)
  4. 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.
  5. 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:

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.

  1. Click the 1 month or 12 months button on the plan you want.
  2. 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#

  1. Open the Admin Panel address your team gave you. You'll land on a simple CoPub Admin sign-in page.
  2. Enter your Email and Password.
  3. Click Sign in.
  4. 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

  1. Type into the Search by email or name… box at the top.
  2. 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

  1. Find the person's row.
  2. Click Deactivate (for an active account) or Reactivate (for a deactivated one) on the right.
  3. A confirmation box appears (for example, "Deactivate name@example.com?"). Confirm to proceed.
  4. 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.

  1. Find the person's row and click Reset name gate on the right.
  2. 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.
  3. 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

  1. Find the feature's row.
  2. Click Enable to switch it on, or Disable to switch it off, for this workspace.
  3. 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

  1. Click Clear in the feature's row (it only shows when you've set a choice).
  2. 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

  1. Find the person's row.
  2. In the Grant a role dropdown on the right, choose a role.
  3. Click Grant. A "Granted…" confirmation appears and the role shows up as a small chip in their Current roles.

Removing a role

  1. In the person's Current roles, each role appears as a chip with a small ×.
  2. Click the × next to the role you want to remove.
  3. 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:

  1. 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).
  2. Choose a role from the dropdown.
  3. 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

  1. In the Switch plan dropdown, choose the tier you want.
  2. 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:

  1. In the Top up credits field, type a whole number (at least 1) — for example, 1000.
  2. 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

  1. Type into the Filter by action type box (it even suggests an example, like a feature-flag-set action).
  2. 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

  1. Find the model you want and click Select in its row.
  2. You'll see a confirmation reminding you of the two remaining steps: restart CoPub, then re-embed.
  3. 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.

  1. Click Re-embed entire corpus near the top of the page.
  2. 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#

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#

How to use it#

  1. Open Create your account. Under the heading, "Sign up with your email and password." introduces the form — there is no Google or Microsoft option.
  2. 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).
  3. 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.
  4. Press Sign up. It reads Creating account… while it works.
  5. 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.
  6. 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#

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#

How to use it#

  1. Type your address into Email. Capitalisation does not matter: [email protected] and [email protected] are treated as the same account.
  2. Type your Password.
  3. 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.

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#

How to use it#

  1. On the sign-in page, click Forgot password?.
  2. 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.
  3. 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.
  4. Open the email titled Reset your CoPub password and press Reset my password in it. Do this within ten minutes of asking.
  5. 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.
  6. 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.

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#

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#

  1. 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.
  2. 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.
  3. Open a project — click its title, or go straight to a part of it with Editor, Notes or Refs.
  4. 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.
  5. 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#

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#

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#

  1. Open New project from the dashboard.
  2. 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.
  3. Optionally fill Target journal (placeholder "optional — e.g. The Lancet, NEJM, BMJ"). Press Next.
  4. 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.
  5. 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.
  6. 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#

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#

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:

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#

  1. Open the project and go to Overview.
  2. Find the person under Members.
  3. 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#

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#

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:

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 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#

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:

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#

  1. Select the text you want to change — or just place the cursor in a paragraph if you are changing its structure.
  2. 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#

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#

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:

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"#

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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#

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#

How to use it#

  1. Type. After a short pause — about 0.6 seconds — a suggestion appears in grey after your cursor.
  2. 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#

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#

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#

  1. Select the text.
  2. Open AI edit and choose a command, or type your own instruction.
  3. The proposed rewrite streams into a panel — your document is not changed yet.
  4. 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#

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#

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#

  1. Open the document and click Review.
  2. Pick a lens and click its Run button, or Run review for the full pass.
  3. Watch the counter — it reports progress as X of N sections.
  4. When it finishes, read the findings in the panel.
  5. 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#

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:

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#

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:

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#

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#

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:

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:

How to use it — the toolbar picker#

  1. Put the cursor where the marker should go.
  2. Click Cite on the formatting toolbar, or press Ctrl+Shift+C.
  3. 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:

  1. 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.
  2. Keep typing to filter. Every keystroke narrows the list against the paper's authors, its year and its title, so 2024 or a word of the title works as well as an author's surname.
  3. Move with the ↑ and ↓ arrows. The first match is highlighted already, so often you can skip this.
  4. 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#

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#

Two tiers, and why it matters#

Cite looks in two places, in order:

  1. Your project library — the papers you have already collected. Always searched.
  2. 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#

  1. In your document, select the sentence or claim you want to support.
  2. Click Cite.
  3. The panel opens on "Looking through your library…" while it searches.
  4. 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.
  5. 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#

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#

How to use it#

  1. Paste the DOI into your document.
  2. A small prompt appears offering Cite, Link or Plain.
  3. 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#

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#

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#

  1. Open the citation-scope form.
  2. Set the limits you want. Changes save as you make them, per document.
  3. 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#

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 /library still work — they redirect here. What was on that screen is now the Collections tab, described below.

Before you start#

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:

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#

  1. 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.
  2. 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.
  3. Click a title to open the detail panel on the right.
  4. 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.)

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#

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#

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#

  1. Open Find papers.
  2. Type a query and search.
  3. 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.
  4. 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#

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#

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:

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#

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#

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#

How to use it#

  1. Highlight the passage in the document body.
  2. 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.
  3. The Comments panel opens on the right showing a New thread block that quotes what you highlighted.
  4. 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:

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.

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 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#

Sharing & publishing#

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#

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#

  1. Open the document and click Share.
  2. Under New link, choose an Access level.
  3. Optionally set an Expires date and time — shown in your own local time. Leave it blank and the link works until you revoke it.
  4. Click Create link.
  5. 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#

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#

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#

  1. Open the document in the editor.
  2. Click the … button in the document header.
  3. 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.
  4. 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 PDF 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#

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#

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#

  1. Open the Admin Panel and sign in.
  2. Go to Feature flags and select the workspace.
  3. Find the capability.
  4. 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#