What is a "topic"?

A topic is just a piece of work to be done. Topics can capture something as quick and simple as “fix homepage typo” or as large and complex as a multinational product launch.

If you're coming to Flat from another tool, you might be familiar with a topic being called a "ticket", "issue", "work item", or "card".

Every topic has its own page in Flat. It's like a lightweight hybrid of a real-time collaborative document, a status-tracking spreadsheet, and a chat room, providing a central gathering place to collect the context and resources related to a piece of work, and to discuss it.

What is a "workspace"?

A workspace houses topics going through the same workflow steps and presents the topics visually as a board or list. The steps can be as simple as To doIn progressDone, or as many as you like.

Workspaces are great for:

  • Separating the work of different teams, to keep clutter to a minimum for everyone.

  • Separating work that moves through different workflows.

  • Keeping sensitive or confidential topics private to a subset of your organization (via private workspaces)

Can you help me get my team set up?

We’ve designed Flat so that you can get your team fully set up in just a few minutes using our Getting started guide. But if for any reason you have a question, just reach out to us, and we'd be happy to help.

Common tasks

How do I create a topic?

Learn more: Creating topics

How do I create a workspace?

Just hover over “Workspaces” in the sidebar, click the “+” button and enter a name for the new workspace.

Learn more: Managing workspaces

How do I change the columns of a workspace?

To edit a workspace's stages, just visit the workspace and click the workspace's name to open the Workspace setup dialog.

Learn more: Workflow stages

How do I edit multiple topics at the same time?

Flat's Quick edit feature lets you easily make light edits to topics while viewing a workspace. You can launch it using the keyboard shortcut E or by holding Shift, then clicking on one or more topics. Then, just type what you want to change in the input box — like a label name, user's name, due date, or anything else — and Flat will offer suggested edits that you can apply.

Learn more: Selecting and editing topics

Importing and exporting data

Can I import data into Flat from another tool?

Of course! Learn more about importing data here.

Can I export data out of Flat?

Yes, contact us and we'd be happy to export your team's data.

If you're a developer, you may also want to check out our GraphQL API, which allows you to fetch your data in exactly the format you need.


I have an idea for new feature. Can you build it?

Possibly! We love hearing from users about how we can improve Flat, whether the idea is big or small. You might be surprised that some of Flat's most innovative features sprouted directly from user conversations. Let us know what you have in mind, and we'd be happy to chat.

I'd like to integrate Flat with another tool I'm using. Can you build an integration?

Possibly! We already have a roadmap of additional integrations we're planning, but hearing from users helps us prioritize. Let us know what you're thinking.

You may also want to check out our integration with Zapier which enables you to integrate Flat with other tools.

Does Flat integrate with GitLab?

Not currently, but it’s on our roadmap. If you’re using GitLab and are eager to adopt Flat, please do let us know, as it helps inform our prioritization.

Can I run Flat on-prem?

Not at this time, but let us know if that's something you're interested in.

I have a question that's not answered here.

Not to worry, just reach out to us, and we'll be happy to help.

Last updated