# monday.com app · Comma Docs

Canonical: https://commareports.com/docs/monday

> Install Comma for monday.com, connect your workspace, and send a document from any board item out for review. PDFs get a real text layer so reviewers comment on the sentence they mean.

# Comma for monday.com

Your team generates documents in monday — proposals, invoices, reports,
statements of work. Then they leave. The file goes to a client or an executive,
the feedback comes back as an email thread or a marked-up PDF, and someone
retypes it into the item by hand.

The Comma app closes that loop. Attach a document to a board item, send one
review link to anyone, and the sign-off comes back onto the item.

## Install

1. Open the installation link:
   `https://auth.monday.com/oauth2/authorize?client_id=187c87f619d05bdcc24de476c87c3794&response_type=install`
2. Choose the monday account to install into and approve the permissions.
3. monday will confirm the app is installed on your account.

The app requests four scopes and nothing more: `me:read` to know who is
looking, `boards:read` and `assets:read` to find the document already attached
to the item, and `updates:write` to post the verdict back. It asks for no write
access to your boards or columns.

## Add the Comma tab to a board

Installing makes the view available; you add it per board.

1. Open any item so the item panel appears.
2. On the tab strip — **Updates / Files / Activity Log** — click **+**.
3. Choose **Explore more views**, then **Installed Apps**, then **Comma**.
4. The tab is added. Rename it if you like.

## Connect your Comma workspace

The first time you open the Comma tab you'll see **Connect Comma**.

A **monday admin** has to do this, once per monday account. Click it, sign in to
Comma in the window that opens, and it closes itself. Everyone else in the
account is then ready — there's nothing for individual members to set up.

The connection is deliberately account-wide: one monday account maps to one
Comma user, and the panel reads through that user's permissions. It's the same
trust level as a file attached to a monday item. Only a monday admin can create
or change it.

## Send a document for review

Open the Comma tab on an item.

**If a document is already on the item** — a PDF or HTML file in a files
column, or a link column pointing at a page — Comma finds it. One readable file
is imported automatically; several are listed so you can pick.

**Otherwise**, paste a Comma link and press **Attach**.

Either way the panel then shows the document's review state and gives you
**Copy review link**. Send that link to whoever needs to sign off. They don't
need a monday seat or a Comma account.

### PDFs

PDFs are rebuilt rather than embedded. Each page is rendered at 2× and pdf.js's
text layer is laid over it, so the document looks exactly like the PDF _and_
reviewers can highlight the specific sentence they're questioning. Comments
anchor to that text, the way they would on a web page.

Documents up to 15 MB and the first 30 pages are imported; longer files render
what fits and say so.

## What comes back

The panel shows open and resolved comment counts and the current verdict:

- **Awaiting review** — nobody has given a verdict yet.
- **Approved by …** — every named reviewer signed off.
- **Changes requested by …** — at least one reviewer wants edits.

When a verdict lands, Comma posts it onto the monday item as an update, so the
people who never leave monday see the decision without going to look for it.

Edit the document after sign-off and the old verdict is marked **stale** rather
than quietly counting as approval — the panel says so, and the update history
keeps the original.

## Uninstalling

Removing the app deletes the link between your monday account and your Comma
account immediately, through monday's uninstall webhook.

Your documents are not deleted. They belong to your Comma account, they were
stored against your plan, and they usually outlive the board they were reviewed
against. Uninstalling an integration isn't a request to destroy documents — if
you want them gone, delete them in Comma.

## Troubleshooting

**The Comma tab shows "This view runs inside a monday.com item."** The view was
opened outside monday. Open it from an item's tab strip.

**"Connect Comma" keeps appearing.** The account isn't linked yet, or a
non-admin tried to link it. A monday admin has to complete the connection.

**Nothing is found on the item.** Comma reads PDF and HTML files. A `.docx` or
`.xlsx` is listed as not reviewable. Either export HTML or PDF from your
document generator, or point a link column at the document.

**"That doc is no longer reachable."** The attached Comma document was deleted
or its sharing was changed. Attach a different link.

## Related

- **[Sharing & access control →](/docs/sharing)** — what review-link visitors
  can do.
- **[API tokens →](/docs/api-tokens)** — for automating the same flow outside
  monday.
