Skip to main content
Teio structures your work around a clear, three-level hierarchy: workspaces contain projects, and projects contain tasks. This model keeps everything organized by team or purpose at the top level, while giving you the flexibility to break work into focused, manageable units. Understanding how these pieces fit together will help you get the most out of Teio from day one.

​
The Teio data model

Every object in Teio lives within a defined layer of this hierarchy. Changes you make at any level are immediately visible to everyone with access, so your team always works from the same source of truth.

​
Workspaces

A workspace is the top-level container in Teio. It represents your organization, team, or a major business unit — whichever boundary makes sense for how your people are organized. Everything in Teio, including members, projects, and settings, lives inside a workspace. When you sign up for Teio, you create or join a workspace. You can belong to multiple workspaces if you work across different organizations or clients, and each workspace has its own independent membership, billing, and configuration.
Workspace settings, such as SSO configuration, billing, and default member permissions, are managed by workspace owners and admins. If you need to change these settings, contact your workspace administrator.

​
Projects

Projects are organized collections of work within a workspace. A project might represent a product launch, an ongoing business function, a client engagement, or any grouping that helps your team focus. You can create as many projects as your plan allows and customize each one independently with its own workflows, views, and fields. Members with the appropriate role can create, archive, and delete projects. Projects can also be set to private so that only explicitly added members can see them, or left open for the entire workspace to access.
Use descriptive project names that make the scope immediately clear. Names like “Q3 Marketing Campaign” or “Mobile App v2” are easier to navigate than generic names like “Project 1”.

​
Tasks

Tasks are the individual units of work inside a project. Each task represents one actionable item: a feature to build, a bug to fix, a document to write, or any other discrete piece of work. Tasks support titles, descriptions, assignees, due dates, priority levels, labels, and custom fields, giving you the context you need without switching tools. Tasks can be organized within a project using statuses and sections. You can also link related tasks together, add comments, and attach files directly to a task to keep all relevant context in one place.

​
Members and roles

Access in Teio is controlled by roles. Each workspace member holds one of three roles, which determines what they can see and do.
RoleDescription
OwnerFull administrative control. Can manage billing, delete the workspace, and assign any role.
AdminCan manage members, create and delete projects, and configure workspace settings. Cannot access billing or delete the workspace.
MemberCan view and contribute to projects they have access to. Cannot change workspace-level settings.
Project-level access can further restrict what a member can do within a specific project, regardless of their workspace role. A workspace admin who is not added to a private project cannot see that project’s content.

​
Real-time collaboration

Teio syncs changes across all active sessions automatically. When a teammate updates a task status, adds a comment, or changes an assignee, you see the update instantly — no manual refresh required. This live sync applies across the entire product, from the task list to individual task detail views. Real-time collaboration means you can work alongside your team without worrying about overwriting each other’s changes or working from stale data. Teio handles conflict resolution in the background, so the most recent save always wins.
1

Open a shared project

Navigate to any project you share with a teammate. Both of you can have the same project open simultaneously.
2

Make a change

Update a task — change its status, add a comment, or edit the description.
3

Watch it sync

Your teammate sees the change appear in their view within moments, with no action required on their end.

​
Key term definitions

The top-level container in Teio. A workspace represents an organization, team, or business unit. It has its own membership list, billing, and settings. You can belong to multiple workspaces, each completely independent of the others.
An organized collection of tasks within a workspace. Projects can represent a product, campaign, team function, or any logical grouping of work. Each project has its own statuses, views, and access settings.
An individual unit of work within a project. Tasks hold all the details needed to complete a piece of work: title, description, assignee, due date, priority, status, and any custom fields you’ve configured.
The highest-privilege role in a workspace. Owners have full administrative control, including billing management, workspace deletion, and the ability to assign any role to any member.
A workspace role with elevated permissions to manage members, create and delete projects, and configure workspace-level settings. Admins cannot access billing or delete the workspace.
The standard workspace role. Members can view and contribute to any project they have been granted access to, but cannot change workspace settings or manage other members.
Teio’s automatic, live synchronization of changes across all active sessions. Any update made by one user is reflected immediately for all other users viewing the same content, without requiring a page refresh.
A project with restricted visibility. Only workspace members who have been explicitly added to the project can see its content, regardless of their workspace role.