Skip to content
flowplanDocumentationCommunityMarketplaceStart page

Getting started

Pages and spaces

Everything in Flowplan is a page in a tree. Spaces structure the tree, workspaces keep teams apart.

12 min read

On this page
  1. Structure
  2. Page types
  3. Page actions
  4. Right-click in the sidebar
  5. Filter pages
  6. Arrange and move
  7. Favourites and "Linked from"
  8. Manage spaces
  9. Order of spaces
  10. Collapse and expand the sidebar
  11. Focus a branch in the sidebar
  12. Trash

More on this topic: Library: spaces as shelves of books · Tags, properties and aliases · Links, mentions and the graph

Structure

LevelWhat it is
WorkspaceA separate world with its own members, groups, templates and storage quota. Switch with the name at the top of the sidebar.
SpaceA section in the sidebar, e.g. "Teamspace" or "Private". Open to all members or private.
PageDocument, database, whiteboard, journal or dashboard. Pages can have sub-pages at any depth.

Page types

  • Document: text made of blocks – headings, lists, tasks, tables, code, formulas, diagrams, embeds. See Documents and the editor.
  • Database: records with properties, shown as a table, board, calendar, timeline, gallery, list, feed, chart or form. See Databases.
  • Whiteboard: an infinite canvas with sticky notes, shapes, connectors, pen and frames. See Whiteboards.
  • Journal: one page per day, open tasks move along. See Journal.
  • Dashboard: tiles with metrics, charts, database views, tasks due and notes. See Dashboards.
  • Workflow: a flow of trigger, logic and actions that runs in the background. Guests do not see workflow pages. See Workflows.

Page actions

The … menu at the top right of every page offers:

ActionEffect
Change icon, change coverEmoji, symbol or your own image; upload a cover image or choose an existing one and set its position.
Full widthThe content uses the whole window width – for everyone who opens the page. If you turned on Show pages at full width under Settings → Appearance & language → Editor, you see every page this way; the entry then says "Your setting". Since 0.9.6
Change fontDefault, serif or mono for this page.
Lock pageProtects against accidental changes until someone unlocks it.
DuplicateA copy including sub-pages, databases and files; internal links point to the copies.
MoveBelow another page, into another space or workspace.
Save as templateSee Templates.
Export, print / PDFSee Import, export and versions.
PresentShow a document as full-screen slides, see Present.
Open a page beside it …Open a second page on the right in the split view.
Owner and review …Who looks after the page and when it should be checked again, see Owner and review date.
Version historyCompare and restore earlier states.
Move to trashRemoves the page with its sub-pages; restorable.

Clicking a page's icon also opens the picker for an emoji, a symbol or your own picture; Add cover appears when the pointer is over the title (always on a phone). If you prefer the icon small next to the title rather than large above it, choose Next to the title under Settings → Appearance & language → Page icon – Add cover then sits in a narrow row above the title. There is no need for an emoji in the title itself, so export file names stay free of emoji. The icon size you choose (small, medium, large) applies to the view above the title; next to the title the icon is as high as a line of the title. Printing shows the page as you see it.

Removing old cover images: a cover you replaced or removed stays as an image of the page and can still be chosen under Change cover → Existing image. Images that nothing in the workspace uses any more – no page, record, whiteboard or comment – carry the Not used badge there and a Remove button. After a confirmation the image goes to the trash under Deleted files, from where you can restore it – just like deleting in Media, with the same rights: whoever may edit the page, not readers and guests. The current cover and images still in use cannot be removed there. Encrypted spaces have neither covers nor this badge. New in 0.10.2, in the :beta image

On a phone a page's top bar holds only ☰ (sidebar), the title – fully readable, long titles wrap – and ⋯. Follow (bell), Favourite (star) and Share sit at the top of the ⋯ menu with their state, Reading mode below them. The comments button shows in the bar only when the page has open comments, with their count; otherwise Comments is in the menu. The cloud for the saving state appears only when there is something to report: offline, while changes are on their way, or after an error.

Right-click in the sidebar

Right-clicking a page in the page tree or under favourites – a long press on a phone – opens its actions directly: Open in new tab, Open in split view, Copy link, Add to favourites, Share, Add sub-page, Change icon, Duplicate, Move, Export, Lock page and Move to trash. Actions with a dialog open the page first. If the page is part of a selection of several pages, the actions apply to all selected pages. Since 0.9.6

Filter pages

The Filter pages field above the page tree hides everything that does not match; parent pages of the hits stay visible and expanded. Esc clears the filter. Templates, media, tags, graph, trash, settings, help and administration sit as a toolbar at the bottom of the sidebar. On a phone they are gathered behind More next to your name – the only button in that row, so your name and the connection status stay fully readable: a tap opens a list of all of them with labels, and the page tree keeps its height. Below a line it also holds what the account menu ⋯ offers on a computer: light or dark theme, About Flowplan, Legal notice and Privacy (when the instance has set them up) and, last and set apart, Sign out.

Arrange and move

  • Reorder pages in the sidebar by drag and drop, or drag them onto another page to nest them. Dropped onto a record with sub-pages (below its database) or onto the sub-pages of an open record, the page becomes its sub-page. On touch screens a handle only picks something up after a short hold (about 0.3 seconds, with a short vibration); swiping before that scrolls the page, and a quick tap works as usual. The same goes for blocks in a document, home page widgets and records, cards and columns in databases. With a mouse or pen it starts right away.

  • Select pages (the tick icon on a space) or ⇧-click marks several pages (Ctrl/⌘-click then adds more). The selection bar offers Move, Duplicate and Trash; under ⋯ – or by right-clicking (long-pressing) a selected page – you also find Lock pages and Unlock pages, Add to favourites or Remove from favourites, and Copy links (one link per line). If only part of the selection is locked or starred, both actions show with their count, e.g. "Lock 2 pages". Pages you may not edit are skipped when locking, and the message tells you how many. Only the selected pages are locked, not their sub-pages. Since 0.9.6

  • Moving to another workspace takes sub-pages, database records and files along. Shares with groups or people who are not members there are dropped. Databases with relations to databases staying behind have to be detached first.

  • Moved to another space (or workspace), pages keep the tags and properties of the whole workspace. If they (or their sub-pages and the records of their databases) carry tags or properties that apply only in their current space, a step Bring tags and properties along asks for each one:

    • Map to a tag or a property of the same type at the destination – the one with the same name is suggested if there is one,
    • Copy to “destination” – a tag or property of its own in the destination space, with all values (the default when there is nothing of the same name there; if the name is taken there, the copy gets the old space's name added, e.g. “Phase (Sales)”),
    • Remove – the values are lost then.

    Without this choice nothing moves – not by drag and drop, not when moving several pages, not through the API: values are never dropped silently. Undo brings the pages back and maps their tags to the ones of the same name in the old space again. The originals in the old space stay.

Note

Pages keep their address when moved. Links to the page keep working as long as the reader has access in the new workspace.

Favourites and "Linked from"

The star in the header (on a phone Favourite in the ⋯ menu) puts a page under Favourites in the sidebar – personal, others do not see your favourites. At the bottom of every page, Linked from shows which pages and database records refer to it.

Manage spaces

Via … next to a space → Edit space … or Settings → Spaces:

  • rename it, give it an emoji or symbol and one of nine colours, or an image of your own: Upload image next to Choose icon crops a PNG, JPEG, WebP or GIF to a small square (as for the workspace image); only people who can see the space receive it, and Remove goes back to the default folder icon,
  • switch the visibility between open (all members) and private,
  • Duplicate space: an independent copy of all active pages, records and attachments; comments, versions and shares are not copied,
  • Git export (only for the owner of the space, when the administration has switched it on): push the space into a Git repository daily or weekly, see Git export of a space,
  • move it to the trash. The last active space stays until there is another one.

Order of spaces

Workspace owners decide in which order the spaces appear in the sidebar – the same for every member:

  • Drag: grab a space by its header (name and symbol) and drop it above or below another space. A blue line shows where it lands.
  • Keyboard and phone: … next to the space → Move up or Move down. Screen readers announce the new position.
  • Settings → Spaces lists the spaces in the same order, with arrows to move them.

Other members see the new order within a few seconds, without reloading. Wherever spaces are offered for choice – moving, sharing, the browser extension, record to page – the same order applies.

  • New spaces go to the end, a duplicated space right after its original.
  • A space restored from the trash returns to its old place.
  • A restore archive keeps the order of its spaces; on import they go to the end. Older archives without an order keep their previous one.
  • Spaces you cannot see – private spaces of others, encrypted spaces without the key – keep their place. Their names appear nowhere; reordering changes nothing about visibility.
Note

Through the API the command space.reorder ({ workspaceId, order: [spaceIds] }) sets the order of the spaces you see in the sidebar; only workspace owners may do this. The answer lists the visible spaces in their new order.

Collapse and expand the sidebar

A click on a space's name collapses its pages or expands them again, and the same works for Favourites and Collections; the arrow in front of a page shows or hides its sub-pages. Pages with sub-pages start collapsed.

Flowplan remembers what you expanded and collapsed – in your account, per workspace, so it is the same on all your devices (browser, phone, desktop app) and after reloading. This covers pages, spaces, favourites, collections and the year and month folders of journals. Others do not see your choice.

  • Open page: opening a page expands its space and the pages above it so it is visible in the sidebar; nothing else collapses. This only lasts for the visit – after a reload, only what you expanded yourself stays open (plus the way to the page that is open).
  • Expand all / Collapse all: in a space's … menu, for all pages of the space.
  • While filtering the page tree, everything with matches is open.
  • Deleted pages and spaces drop out of what is remembered.
Note

Through the API, the command sidebar.state ({ workspaceId, changes: { "<key>": true|false } }) saves changes; the keys are p:<page> (expanded), s:<space> (collapsed), g:favorites, g:collections and jo:/jc: for journal folders. The bootstrap returns the state as sidebar.

Focus a branch in the sidebar Since 0.9.8

With many nested pages the tree gets long. Right-click a page with sub-pages (a long press on a phone) → Focus in sidebar, or ⋯ on the open page → Focus in sidebar: the page tree then shows only this page and its sub-pages, the page itself at the top and always expanded.

  • Above the tree, ← goes up one level, and the path shows where you are: a click on a page above focuses it, a click on the space shows the whole tree. × (or Esc in the tree) ends the focus.
  • Opening a page outside the branch – via search, a link or back/forward – shows the whole tree again, with a short note and Focus again. That way the open page is always in the sidebar.
  • Flowplan remembers the focus per workspace on this device, also after reloading. Drag and drop works within the branch.

Trash

Deleted pages and spaces end up in the Trash at the bottom of the sidebar, deleted database records below them under Deleted records. Files deleted from Media are listed under Deleted files. There they can be restored or deleted permanently. Publications, share links and forms are switched off when deleting and are not switched on again automatically when restoring.

  • Restore brings a page back with the sub-pages that were deleted together with it. Sub-pages that were already in the trash before stay there – with their own retention period.
  • Delete permanently next to a page deletes it together with its sub-pages in the trash. The dialog names the page and how many sub-pages go with it. You need the same right as for deleting it: editing the page. Sub-pages you may not edit stay in the trash on their own.
  • Empty trash deletes everything in the trash you may delete: pages you may edit, spaces you manage and deleted records you may edit. The dialog shows the counts first. Pages from other people's private spaces and pages you can only read are left untouched.
  • Deleted permanently are the page with its content, versions, comments and inline comments, for databases the properties, views and records, plus uploaded files, favorites, publications, share links, notifications and search results. Links from other pages then point to a deleted page. This cannot be undone; a backup is the only way back.
  • After 30 days in the trash everything is deleted permanently by itself – pages, spaces, records, files and templates. The line at the top names the period, and every page shows how many days it has left. Admins change the period under Limits & retention (0 = never automatically).

Right after deleting, Flowplan shows a notice at the bottom such as “‘Notes’ moved to the trash” with Undo – for about six seconds, longer while the pointer or the focus rests on it. Undo or ⌘Z (outside text fields) brings the page back with its sub-pages and opens it again. The same goes for moving pages in the page tree and for several pages at once.

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

Found a mistake or something missing?Edit on GitHub