Skip to content
flowplanDocumentationCommunityMarketplaceStart page

Collaboration and search

Sharing and publishing

Share at the top right of every page (on a phone at the top of the ⋯ menu) opens Share page. A line at the top sums up how the page is shared right now – space, people, links and whether it is published. Below, three tabs handle one thing each: People (who in the workspace may access it), Links (named links for outsiders; only for those who may do more than read) and Web (publishing). Longer explanations sit behind the small (i). At the bottom, Copy link to page copies the page's address for everyone with access, and Done closes the dialog.

13 min read

On this page
  1. Access in the workspace
  2. Share a page with a person
  3. Links with their own permissions
  4. Editing whiteboards and notebooks with guests
  5. Password and expiry date
  6. Publish on the web
  7. Light, dark and back to the view
  8. Flashcards through a link
  9. Appearance
  10. Custom domain
  11. Share a single record
  12. Forms

Access in the workspace

Pages inherit the permissions of their space and parent pages; below the list, the People tab names who comes in through the space (such as “Plus all 8 members of the space Team”, with Manage space for those who may). In addition, individual people or groups can be given permissions:

RoleMay
ViewRead and comment
EditChange content, records and views

Private spaces and pages are only visible to the people they are shared with. Guests only see what has been explicitly shared with them (see Workspaces, members and permissions).

Share a page with a person

A page or database can be shared with someone who is not in the workspace – without taking them into the whole workspace. Share → People: enter an e-mail address (members are suggested), choose View or Edit, Add.

  • The person already has an account on this instance (with a confirmed address): they have access to the page and its sub-pages right away and get a notification in the inbox ("… shared “Page” with you") and – when the instance sends e-mail – right away an e-mail with a link to the page. Settings → Notifications → Pages shared with you turns the e-mail off. If they are not in the workspace yet, they join as a guest and see only what is shared with them.
  • No account yet: they get an invitation by e-mail (when set up) and are listed as "Invited". Once they create an account with this address, the page is there. The same goes for an account whose address is not confirmed yet – then only the invitation link (Settings → Members → Pending invitations → Copy link) opens the page.
  • Guests do not see the list of people with access; only those who may share see e-mail addresses. Each person sends at most a few dozen invitations an hour, and each address gets only a few e-mails.
  • In the list, roles can be changed and people removed. A guest without any shared page left is no longer in the workspace either.
  • Owners of the workspace and owners of the page's space may share. Everyone else only sees the list.

In the Links tab, + New link creates as many named links as you like, e.g. "Feedback from the customer": choose a name and permission, optionally sub-pages, a password and an expiry date, then Create link. Each link in the list has a copy button and a ⋯ menu.

Link permissionVisitors may
Readlook at the page
Read and commentalso comment; comments carry a guest note
Read, comment and editalso change the title, text and visible properties of existing records
  • Links work without an account and can be revoked one by one (⋯ → Revoke).
  • With edit links, guests write along live: changes by members and other guests appear right away, and cursors are visible both ways – guests appear as "Guest · ". They write in the same editor as in the workspace: a toolbar with text style, formatting, lists, alignment, formula, diagram and file; / or + opens the block menu (headings, lists, quote, callout, code, divider, formulas, Mermaid, file). Since 0.9.6
  • Optionally they also apply to the sub-pages that exist right now; new sub-pages are not added automatically.
  • Edit links cannot change permissions, members, private relations or files properties. Before every guest edit, Flowplan saves the previous content.
  • A journal with a PIN can be neither shared by link nor published; setting the PIN revokes existing links and publications. Sharing a page above it with its sub-pages leaves it out.

Editing whiteboards and notebooks with guests Since 0.9.6

If you share a whiteboard or notebook via a link with Read, comment and edit, guests see an Edit whiteboard or Edit notebook button above the preview picture. They then work in the same editor as you, without an account and live: everyone sees the others' changes right away.

  • Whiteboard: add, move and delete notes, text, shapes, connectors, frames, tables and emoji, draw and comment. Their pointer shows as "Guest · ".
  • Notebook: write and draw on the sheets and add, duplicate, delete and reorder sheets.
  • Not possible: uploading files, templates, AI and facilitation features (votes, timer, private mode), linking pages and exporting. Guests see existing images and PDFs, but not references to pages outside the link.
  • If the page is locked, or the link expires or is revoked, editing stops right away. Pages in encrypted spaces and journals with a PIN can't be edited this way.

Password and expiry date

Links with their own permissions and publications can have a password and an expiry date – when creating them or later: for links via ⋯ → Password and expiry date, for the publication in the Web tab under Password and Expires. The list shows "Password" or "expires on …".

  • Visitors enter the password once per device. It is valid for up to 12 hours and only for this link; a new password signs all visitors out.
  • Ten wrong attempts within 15 minutes block that address for the link.
  • Editing links have daily budgets: per link, guests upload at most 200 MB of files per day (20 files per 10 minutes) and send at most 100 MB of changes per day; a document does not grow beyond 3 MB of text through a link. For the whole instance FLOWPLAN_ANONYMOUS_UPLOAD_MB applies on top (Configuration).
  • After the expiry date the link only shows "expired" – no content, no files, no live updates.
  • You can remove the password or extend the date at any time.
  • Password-protected publications cannot be copied into other workspaces.
  • The password is stored only as a hash and never shown again.

Publish on the web

In the Web tab, the Publish on the web switch makes the page readable for everyone with the link. Then come the public link (Copy or open it) and the options:

  • Also publish the current sub-pages; Add new sub-pages to the selection brings in ones created later.
  • Publish new sub-pages automatically (only together with the sub-pages): pages that are later created under the published page, moved there, duplicated there or restored there – also by others and at any depth – are public without another step, with this publication's password, expiry, copy setting and look. If such a page is moved out again, it is no longer published. Never published automatically: pages you could not publish yourself (without your edit rights), journals with a PIN, workflow pages and pages of encrypted spaces. If you switch the option off, the sub-pages that joined until then stay published; new ones no longer join.
  • Visitors may copy it into their workspace – only what the publication shows.
  • Show ↗ arrow after links: whether links to the web on the published page carry the small arrow. Preset from your setting Icon on external links; publications from before this version keep the arrow. Since 0.9.7
  • Databases appear with their views – table, board, gallery, list, feed, calendar, timeline and chart (also with series and more values) –, records and record documents. A view is only published if all properties it needs are public. Person properties, relations, formulas, rollups and internal comments stay private.
  • The timeline looks as in the app, read-only: with the period and zoom you saved in the view, the two-row axis, milestones as diamonds, titles that stay at the left edge and the chosen public properties beside them, weekends, today's line and the view's sorting. Records outside the period stay as empty rows, cut bars are marked. Dependency arrows and the critical path appear as set up – only between published records, and not when a read rule protects the dependency property. Visitors can scroll and zoom; nothing is saved. New in 0.10.2, in the :beta image
  • Files linked in published pages are public; other uploads are not.
  • Switching it off, deleting or moving a page out of the published tree revokes access immediately, including to files.
  • If a page has headings, visitors show its outline with the list icon to the right of the text (on a phone, the round button at the bottom right). It marks where you are reading and jumps to a heading on click. The browser remembers whether it is open – as in the editor.

Light, dark and back to the view New in 0.10.2, in the :beta image

Shared and published pages – single shared records too – have a small sun or moon button at the top right. It cycles through automatic (like the visitor's device), light and dark. The browser remembers the choice on this device, like Light and dark in the app (in local storage under flowplan-theme, no cookie). The publisher cannot preset it: without a choice of their own, the page follows the device.

  • Back to the view: when a visitor opens a record from a view of a database, ← Back to appears above the path. It returns to the same view, with the same month (calendar, timeline) and at the place they had scrolled to. For this the view and its month are part of the record's address (?row=…&view=…&month=…); the scroll position stays in this tab only (session storage). This works for links with their own permissions and for publications alike. Opened from a link in a document, a relation or an address without a view, the record shows just the path.
  • Record beside the view: in windows from 1000 pixels wide, a record opened from a view shows in the side panel beside it – with title, public properties and text; ↑/↓ step through the view's records, Open as page leads to the record's own page. Narrower windows and ⌘/Ctrl-click open it as a page, as before. New in 0.10.2, in the :beta image
  • Title in the path: the path ends with the record's title instead of "Record"; long titles are shortened with "…", the full one is in the tooltip. If visitors may not read the title property (for example because of a restricted visibility), it stays "Record".

A flashcard deck shows its Study view through a link with its own permissions or as a publication:

  • Browse: every card as a grid, 100 per page; a click or Turn over shows the back. Without JavaScript, Turn over folds the back open below the card. New in 0.10.2, in the :beta image
  • Practise: the focus mode with ratings, without an account. The learning state lives in the visitor's browser only (in local storage under flowplan-study: and the link) – no cookie, nothing goes to the server. A note says so once; Delete progress removes it. If the browser allows no storage, the practice lasts for that session only.
  • A study view is public only when every property of the card mapping is public; private records never become cards. Pictures come through the link, password and end date apply as to everything else.
  • Someone signed in to the workspace who may read the deck gets Study in Flowplan with their own learning state. A copy of the publication keeps the card mapping.
  • Study in Flowplan opens the deck in the app on the same study view and starts the focus mode right away – in the phone app too. If the view no longer exists, the deck's first study view opens with a note. On a custom domain there is no such button. New in 0.10.2, in the :beta image

Appearance

In the Web tab, Appearance folds open below the options. There you set the look of the publication: logo and favicon (an HTTPS address or an uploaded file the publication shows), accent colour, footer text and hide “Published with Flowplan” – applied with Save appearance.

Custom domain

When the administration switched it on (Custom domains for publications), a publication can also be shown under your domain, such as docs.example.org:

  1. In the Web tab, open Custom domain, enter the domain and choose Add domain.
  2. At your DNS provider create the TXT record shown: name _flowplan-verify.docs.example.org, value flowplan-verify-…. Only this TXT record verifies the domain.
  3. Point the domain at the Flowplan instance with a CNAME (or A/AAAA) record.
  4. Choose Check now. The reverse proxy obtains the HTTPS certificate – see Custom domains for publications.

A verified domain stays verified until you remove it – including domains verified another way in the past. A domain that is still not verified after 7 days is released again; after that someone else may enter it.

Under the domain there are short addresses (/ for the start page, /<page ID> for sub-pages), a sitemap.xml and robots.txt of its own, and search engines may index the pages; the /share/… link names them as the canonical address. The domain shows only this publication: no sign-in, no app, no API apart from the publication's read access, no cookies, and the pages cannot be embedded in other sites.

Publications with a password cannot be shown under a custom domain. When the publication ends, the domain answers with 404.

Warning

Embedded videos and external images load content from their provider when viewed. This also applies to published pages.

Share a single record

A record of a database can be shared without opening the database: Share at the top of the record (the share icon in the dialog, the Share button on the record's own page) opens Share record. Anyone who may edit the record may share it.

  • Links: as for pages – a name, a permission (read, comment, edit), optionally a password and expiry date; every link can be revoked on its own.
  • Web: Publish on the web makes the record readable for everyone with the link, again with password and expiry date. Guest comments stay with the links; search engines do not index it.
  • Properties: which properties visitors see – for all links and the publication of this record. Preselected are those a publication shows anyway, plus the record's files; empty ones are not shown. Relations (show the titles of linked records, without a link) and people (show names) only appear when you tick them. Properties with read permissions and rollups always stay private.
  • Include sub-pages (when creating a link; a switch on the publication): visitors can also open the record's sub-pages and what lies below them – later ones too, as long as they sit below the record. Sub-pages of other records, the database and its other pages stay hidden.

Visitors see the record's title, icon, cover, the chosen properties and its document – no other records, no views, not the database; the path starts at the record (on a sub-page: record / sub-page). Links in the document to other pages or records are removed for them, and files are only visible when the record itself uses them. With edit, guests change the document (live) and the visible properties, but no relations.

  • Members reach the record as before through the database and the record's permissions; there are no guests of single records – that is what the link is for.
  • Private records cannot be shared; if a shared record becomes private, is deleted, is moved to another database or its database is deleted, its links and its publication end at once.
  • Your links appear under Settings → Security, all of them under Administration → Security.

Forms

Forms have a link of their own, see Forms.

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

Found a mistake or something missing?Edit on GitHub