Skip to content
flowplanDocumentationCommunityMarketplaceStart page

Collaboration and search

Collaboration and comments

Several people write on the same page at the same time without overwriting each other. Comments, mentions and the inbox keep conversations next to the content.

8 min read

On this page
  1. Edit at the same time
  2. Suggest changes
  3. Reactions
  4. Follow pages
  5. Who has seen the page?
  6. Changes since your last visit
  7. Page comments
  8. Text comments
  9. In the margin beside the text
  10. Mentions
  11. Inbox

Edit at the same time

  • Documents and record contents are merged with Yjs (CRDT): every change is kept, even when two people type in the same paragraph.
  • Changes reach the others within a fraction of a second: the server pushes every saved change right away to everyone who has the same document open (server-sent events). Only what changed is sent, not the whole document.
  • Coloured cursors and selections with names show where others are writing; their movements arrive immediately too.
  • The sidebar, open databases and the inbox stay current too, without reloading: when someone creates or renames a page, changes a record in the database you have open, or mentions you, you see it within a few seconds. The server only says that something changed – never titles or pages you may not see; your browser then fetches what changed with your permissions. Several tabs share one connection for this. Without that connection (for example behind a proxy that buffers server-sent events), Flowplan syncs every 10 seconds as before. New in 0.10.2, in the :beta image
  • Without a connection you keep working; changes are merged as soon as the network is back.
  • Database changes are checked for version conflicts: if someone changed the same record in the meantime, your change is not silently written over it but refused, and you see the new state.
  • Guests with an edit link also work live and see the members' cursors; members see the guests as "Guest · ".
  • Whiteboards also have live cursors as in Miro.

Suggest changes

The pen button Suggest in the toolbar turns on suggestion mode. Typing then does not change the text directly:

  • Inserted text appears underlined in green, deleted text stays in place, struck through in red. Typing over a selection creates both.
  • Deleting your own suggestion removes it completely.
  • Above the text, a bar shows the number of open suggestions. Expanded, it lists each one with person and text; a click jumps to the spot. ✓ accepts a suggestion (the insertion stays, the deleted text disappears), ✗ rejects it. Accept all and Reject all settle everything at once.
  • Suggestions are part of the document: they appear for everyone right away and stay saved until someone accepts or rejects them. Everyone who may edit the page can accept and reject.
  • Formatting, paragraph breaks and moved blocks are applied directly even in suggestion mode; other people's changes never become your suggestions.
  • Changes in code blocks are marked as suggestions too. When accepting or rejecting leaves a paragraph or list item completely empty (a suggested new paragraph rejected, a fully deleted one accepted), it disappears as well.
  • Suggestions by the AI: in Ask AI, Suggest as changes puts the answer into the page as suggestions in the same way – with your name and "(AI)".

Reactions

  • Comments: below every page and record comment, the smiley adds a reaction (👍 ❤️ 🎉 😄 👀 ✅ 🙏 🔥). A click on an existing reaction joins it or takes your own back; the tooltip shows who reacted. Everyone who may see the page can react.
  • Paragraphs and headings: selecting text or right-clicking in the text opens the text menu. At the top are the reactions for the paragraph, below them formatting (bold, italic, underline, strikethrough, highlight, code, link), Comment and Copy, in tasks also Due date. The reactions sit as small pills on the block, are saved in the document and appear for everyone right away; a click on your own takes it back. This works for everyone who may edit the page. Shift + right-click brings up the browser's menu.
  • Text comments have their own reactions in the thread.

Follow pages

The bell at the top of a page (on a phone Follow at the top of the ⋯ menu) turns Follow on or off. Whoever follows a page gets a notification as soon as someone else changes it – one per page, until you have looked at it again – and for every new comment on it (for a database: also on its records). With e-mail set up, it lands in the e-mail digest. Whoever creates a page follows it automatically. Under Settings → Notifications, the kind "Changes to pages you follow" can be switched off for inbox, push and e-mail separately.

Who has seen the page?

The eye next to the bell shows who opened the page and when. A tick means the person has seen the latest state; "older" means the page has changed since. Only people who may still see the page are shown.

Changes since your last visit

If someone else changed a page since you last opened it, a notice with their names appears at the top. For documents, Show changes shows the text changes since your last visit (inserted and deleted, as in the version history). For databases the notice gives the number of edited records.

On the home screen, Recently viewed lists the pages you opened last; the quick search with nothing typed shows records too, grouped by day.

Page comments

The speech bubble icon in the header opens the page's comments (on a phone it shows there only when there are open comments, with their count, otherwise Comments is in the ⋯ menu); comments on database records sit below the record. ⌘Enter sends. Page and record comments are plain text. @ followed by a member's full name or e-mail address – say @Anna Berg – mentions the person: they get a notification, provided they may see the page and the record.

Text comments

Below a document and in a database record's content, Text comments (n) opens the comment panel with all threads and the Show filter. Select text or a block and click New at the top of the panel to write a comment; if nothing is selected, Flowplan reminds you to select something first. The speech-bubble icon in the toolbar, in the text menu, or ⌘/Ctrl⌥/AltM takes you straight to a new comment. The X or clicking Text comments again closes the panel. Since 0.9.8

  • The commented text is highlighted; a click on it opens the thread.
  • Replies, emoji reactions, Resolve and Reopen.
  • Posts can be formatted (lists, links, quotes, code); @ opens the person search.
  • Your own posts can be edited and deleted. People newly mentioned in an edit get a notification; those mentioned before are not notified again.
  • If the text is deleted later, the quote stays in the thread.
  • Line breaks in the passage stay line breaks in the quote, and embedded media show as “media block”. When you move a block up or down (or drag it), its comments move with it. Since 0.9.8
  • Drafts stay saved until you send or discard them.

In the margin beside the text New in 0.10.2, in the :beta image

On wide screens – with the sidebar open from a window about 1280 pixels wide – open text comments appear as cards in the right margin, each at the height of its passage, on pages and on records opened as a page. A card shows the start of the first post, who wrote it and how many replies there are. When passages are close together, the cards stack below each other in the order of the text.

  • A click on the highlight or the card opens the thread right in the card, with replies, reactions, mentions and Resolve thread; the passage is highlighted more strongly and the page does not jump away. Esc or a click in the text collapses the card again.
  • A new comment (⌘/Ctrl⌥/AltM or Comment in the text menu) opens its field right in the margin beside the passage.
  • Resolved threads leave the margin. Text comments (n) below the document stays the overview of all threads, with the Show filter.
  • While cards are in the margin, the table of contents folds into its small button at the edge of the text; a click on it opens it as a list.
  • When there is too little room beside the text – a narrow window, the page comments are open – and on phones, the threads are in the comment panel below the document. A click on a highlight opens the thread there and scrolls to it.

Under Settings → Appearance & language → Editor, set Text comments to In the margin (the default) or Below the document. The setting applies to your account on all devices.

Text comments exist in documents and in the contents of database records, also in exports and content archives.

Mentions

  • @Name in text or a comment notifies the person. The person search only shows members who may read the page.
  • Only people who may see the page – and, for a record, the record – are notified; never the author. Someone who would hear about the comment anyway gets a single notification, the mention. If the page lies in a journal with a PIN, the notification only says “This journal is locked.” until the PIN is entered.
  • Guests do not see other members; their mentions notify nobody.

Inbox

The Inbox in the sidebar collects mentions, comments and replies that concern you (who hears about comments), date reminders as well as comments and records from guests. Unread items are marked; a click jumps to the spot – for text comments straight into the thread. You choose which events arrive as push notifications under Settings → Notifications (see Search, inbox and push).

Was this helpful?
YesThanks!
No – tell us what's missing

Found a mistake or something missing?Edit on GitHub