Key concepts

Folioso is built from a few simple pieces: organisations, spaces, groups, pages, teams and roles. This page explains each one and how they decide who can see and edit what.

How the pieces fit together#

Organisation (your-team.folioso.dev)
├── Members and teams
├── General (the default space, open to every member)
│   ├── Group: Runbooks
│   │   └── Page
│   │       └── Sub-page
│   └── Page with no group
├── Other spaces (open, closed or private)
└── My space (one per member, private to them)

Organisation#

An organisation is your team's home in Folioso. It has its own address, such as acme.folioso.dev, and it owns everything inside it: the spaces, the teams, the members and the plan.

• Every account has its own organisation, created when you register.
• You can belong to several organisations, for example your own and your employer's. You switch between them from the top of the sidebar. See Multiple organisations.
• The plan belongs to the organisation, not to you. See Plans.

Organisation roles#

Each member is either an admin or a member.

One admin is also the owner: the organisation's billing contact, who can't be removed while they hold that role. See Roles and ownership.

Space#

A space holds pages and groups, and it's where access is decided. Every space has an access type:

• Open: every member of the organisation can read and edit it.
• Closed: listed for every member, but only the people and teams granted a role can get in. Others can ask for access.
• Private: hidden from everyone without a grant. Available if your plan includes private spaces.

Two spaces are special:

• The default space, named General when the organisation is created. It's always open and can't be deleted, so everyone has somewhere to land.
• My space. Every member gets one private personal space in each organisation they belong to. Only you can open it, organisation admins included. You can still share single pages from it.

See About spaces.

Space roles#

Your role in a space decides what you can do with its pages.

Your role can come from a direct grant, from a team you're in, from the space being open (everyone is an editor) or from being an organisation admin. When several apply, you get the highest. Only a page's author or a space admin can delete a page. See Roles and permissions.

Team#

A team is a named group of members, such as "Backend" or "Support". Granting a team a role on a space gives that role to everyone in it, so you don't have to add people one by one. See Teams.

Group#

A group is a folder inside a space, with a name and a colour. Groups are flat: a group can't contain another group. Each page sits in one group or in none. See Groups.

Page#

A page is a single note: a title and a body that can hold text, code blocks, diagrams, tables, images and alert boxes. Pages save automatically as you type. See Creating and managing pages.

• Sub-pages. You can nest a page under another, up to three levels deep.
• Visibility. A new page is visible to everyone in its space, with the access their space role gives them. The author or a space admin can make a page Private, so only the author and the people it's shared with can open it. See Private pages.
• Author. The person who created the page. If they leave Folioso, the page stays and shows "Former member".

Tag#

A tag is a coloured label on a page, such as php or incident. Tags belong to a space, and every space starts with a tag for each common code language. See Tags.

Sharing#

You can share a single page without giving someone access to the whole space:

• With a person, by email, to view or to edit. See Sharing with people.
• With a public link that anyone can open, optionally with a password. See Public links.

Recycle bin#

Deleting a page moves it to the recycle bin, where it can be restored for 30 days before it's removed for good. See Recycle bin.