Release Notes

Learn about the latest improvements to Clarity
August 2, 2022

Add tables to any document

Organize information into rows and columns

You can now create tables inside your Clarity documents. When lists and outlines just don't cut it, insert a lightweight table and organize information in rows and columns. Move between cells using keyboard shortcuts. Reorder rows and columns using drag-and-drop.

Type "/table" in any document to get started.

For full details on how to get the most out of tables, see the Tables section in our How to use Clarity page.

Watch this GIF demonstrating some of the features of the table block

Fixes & Improvements

  • When viewing a task, you can now easily share a link to the task by clicking "Copy Link" in the top right
  • You can now create both projects and tasks directly inside a Goal
  • When viewing your Weekly, the URL that shows up in your browser's address bar will always link to the latest Weekly. (
  • When creating a new task, you can now add a parent and a cycle before saving the task.
  • In the Base Settings, pending guest invitations now show up in the Guests section of the Members tab.
  • Fixed a bug that opened groups in a new window instead of the split when using shift+click.
  • Fixed a bug with sharing documents that copied the wrong link when sharing a document from the split view. It would copy the link for the document in the main pane instead.
  • When creating tasks from blocks inside a project with multiple groups, you can now pick a group without leaving the keyboard.
July 17, 2022

July 2022 Release Touch-ups


  • You can now set the parent of the task while you're creating it
  • We updated the animation when opening/closing the Share Settings
  • We touched up the appearance of Goals on the Roadmap to better adapt to long titles
  • We now display guest invites that are pending in the Guests list under Base Settings. Previously, they were found in the Members list.


  • Fixed a bug that caused multiple tokens to load briefly when a user attempted to edit token access in a document.
  • Fixed the padding of the create task modal.
  • Fixed a bug that prevented guests from opening a document that they are following
  • Fixed a bug that prevented a yourself from being listed first when changing the Assignee and Reviewer.
  • Fixed a bug that prevented the user from removing a token gate from a document
  • Fixed a bug that caused certain command palette options for modifying tasks to not appear in the list
  • Fixed some visual bugs in the Invite Guests flow
July 8, 2022

Public Bases

For communities who build in public, allow anyone to view your workspace.

Building in the open maximizes serendipity and makes it easy for new contributors to see what's happening before officially joining your base. The best DAO contributors often follow along and help other contributors before proposing a contribution of their own. Previously contributors would need to join your base through an invite link or Join Page in order to see inside. This also required them to connect their wallet or create an account.

Now, you can make you Clarity base public. This means your roadmap, wiki, bounty boards, and notes are visible to anyone on the internet who visits your base. When sharing a document in a public base, you no longer need to turn on public access.

You can now choose between three options for your base privacy settings:

  • Public - The content of a public base is visible to anyone without joining.
  • Private - The content of the base is only visible to members. In order to join, you must be invited or meet specific token requirements. If you set token requirements, then anyone who has the right tokens can join via your base's profile.
  • Secret - The content of the base is only visible to members. The only way to join is by an explicit invite. If someone tries to visit the base's profile, it will say "Base Not Found".

These settings can be found in Base Settings > Details. They replace the Join Page plug-in.

Fixes & Improvements

  • You can now join a base directly from the Base Home Screen.
  • Fixed a bug that prevented you from setting a guest's access level before the guest accepted the invitation.
  • Fixed an issue that prevented the same guest from being invited to multiple documents.
  • Fixed a bug that prevented new Wiki pages from appearing in the list immediately.
  • Fixed an issue that caused task activity to not display correctly.
July 8, 2022

Redesigned Share Settings

When sharing documents, the share settings are now much clearer.

The new Share Settings design makes it clear to whom you're granting access, so you can invite specific people, or grant access to token holders in just a few clicks. You can now set a public document to only have View access, without the ability to edit nor comment.

When working on any document, task, or project, click the black Share button in the top bar. Use the share settings to grant access to specific people who are not members of your base.

Grant access to view, comment, or edit to holders of a specific token, or combination of tokens. They'll just need to connect their wallet to collaborate.

You can also make any document public so anyone with the link can view, comment, or edit it.

Fixes & Improvements

  • When you add a new guest to a document, they're added in real time for everyone else viewing that document.
  • Public documents now support View Only mode, allowing you to easily publish read-only content to your community.
June 24, 2022

Clarity 2.0 Touch-ups


  • When adding a task to a project, the task's group will now be added to the project if it was not previously listed.


  • Fixed a bug that caused projects and goals to appear in a user's personal task list.
  • Fixed a bug that occasionally prevented note titles from appearing in the Recents list.
  • Fixed a bug that caused users to be navigated to the Base Home Screen when switching between bases, instead of their last opened document.
  • Fixed a bug that listed all Wiki articles in lowercase in Recents.
  • Fixed a bug that caused the note title block to disappear when a user's connection was interrupted.
  • Fixed a bug that caused incorrect UI components to appear in a task's Activity section.
  • Fixed a bug that did not maintain a user's collapsed sidebar after refreshing the page.
  • Fixed a bug that caused embedded Figma files to be loaded incorrectly.
  • Fixed a bug that caused projects and goals for archived groups to appear in Group Work and on the Roadmap screen.
  • Fixed a bug that prevented document names in the Activity section of projects and tasks to be clicked.
  • Fixed a bug that prevented icons to be loaded for certain views in Group Pins.
  • Fixed a bug that prevented children blocks to be copied when hitting 'Esc' to select a block.
  • Fixed a bug that caused certain search bar queries to crash the application.
  • Fixed UI components in the Group Profile in the case of no listed group description.
  • Fixed a bug that caused the 'Page Not Found' message to appear when clicking into a document from the Quick Search.
  • Fixed a bug that caused the split view to remain open when switching from one base to another.
  • Fixed the UI for selecting a task's group when creating tasks from blocks.
  • Fixed a bug that did not add the default group to a project created inside a document within that group.
  • Fixed a bug that prevented users from using arrow keys to scroll through blocks after pasting in a nested blocks from one Clarity document to another.
June 8, 2022

Clarity 2.0

Improvements to Groups

  • A Task Board for Every Group. Now each of your groups has its own task board. Tasks are automatically added to the board when you create them in any document or project within the group.
  • Group Projects. Every project has a doc in Clarity. Now, each group can manage its own project list, and you can see all the projects for your group in one place.
  • Group Notes. We use documents to take notes, gather research, and get on the same page. Now each group has its own space for docs.
  • Group Payouts. Groups need autonomy over their own budget and funds. You no longer need to coordinate across groups to pay all contributors i the community at the same time. Each group can manage bounty payouts on their own schedule.
  • Group Activity. When we collaborate remotely, it can be hard to know what everyone is doing. Each group now has an activity feed that shows what notes have been created by other team members. We'll be adding more types of activity to this screen in the near future.
  • Group Pins. If you have a document or link that is important to your group, but not important enough to go on the community home screen, you can pin it to the right sidebar for easy access to everyone in your group.
  • Per-group Workflows. Each group can tailor their workflow to their needs. Customize the task statuses to create different stages for different kinds of work. If you have a development team that typically runs sprints, you can turn on the Cycles plug-in for a single group without affecting the others.

Improvements to the Roadmap screen

  • Shared Roadmap. When a group creates a new project, it automatically shows up on the community roadmap. This means that each group can manage their own projects and the roadmap will always stay up to date.
  • Cross-group Projects. Multiple groups can now team up on a single project. When creating new tasks inside a shared project, simply decide which group is responsible for the task and it will be added to all the relevant task boards for the contributors in that group.
  • Initiatives are now Goals. Create community-wide goals that have multiple supporting projects. This is perfect if your community uses an OKR-like goal structure. Now Goals sit inside your milestones which gives them focus, and helps prevent run-on initiatives that never end.

Repositioning of the Wiki

  • Your Community Library. We're more clearly separating the Wiki from notes. The Wiki is the long-term knowledge store for the community. Think of it like a library. When you tag something, you are adding it to that topic in the community library. The Wiki does not belong to any group—it's like your community's very own Wikipedia.
  • Cross Group Discovery. The Wiki can surface backlinks across all groups. This makes it possible for you to identify similar conversations that are happening across the community. The Wiki can also help you find prior work & research that may be relevant to your current project.

Introducing the Base Home Screen

  • Your Community Bulletin Board. Your home screen is like a community bulletin board. It's the first thing every contributor sees when they join your base. You can put important onboarding instructions and resources front-and-center for them to see.
  • Showcase important documents. Surface important wiki articles, Seasonal memos, community guidelines, and more by pinning them to the home screen of your base.
  • Pin any web page. Add anything you want to your home screen, even if it wasn't created in Clarity. You can use this to link to Mirror posts, Snapshot spaces, Etherscan, and other tools that are relevant to your contributor community.
  • Create collections. Organize your home screen using Collections. Add as many headings as you need to make the home screen easy to navigate.
  • Visible Groups & Roles. Groups & Roles were previously hidden behind a dropdown in the sidebar. Now they are displayed prominently in a tab across the top of the screen. This makes it easier for new contributors to find the right group and set their permissions.

Design Refresh

  • New Design Language. We've refreshed the look and feel of every screen in the product. Starting from buttons, text, and colors all the way up to full page layouts.
  • Simplified Task Board. We've radically simplified the kanban board interface. We've carefully removed every non-essential detail so you can focus on moving cards through your workflow.
  • New Layout for Task & Project Details. We redesigned the layout of tasks and projects to declutter the interface. The properties now have a dedicated space in the right sidebar. We moved subtasks below the task description so they can stay expanded by default. We simplified the activity feed by grouping entries that are made by the same person within five minutes.
  • Redesigned Roadmap. The Roadmap is where new and existing contributors can find out what’s happening across the community. The new layout is easier to skim thanks to a refreshed layout and typography.

Improvements to Navigation

  • Radically Simplified Navigation. We've rethought every part of how you get around Clarity, with a focus on making it more accessible to new contributors.
  • More Recents. We increased the number of recently opened documents Clarity remembers from 6 to 25. This list is now available even when the sidebar is hidden because it's in the new top bar. Recently opened docs also show i the Quick Search by default, making them accessible instantly via keyboard as well.
  • Unified Search. Now there is a single search box for your workspace. Find anything with a click, or by pressing Cmd/Ctrl+P. The search field is front-and-center at the top of the screen, which makes it easy for new contributors to find something specific without knowing their way around Clarity.
  • Unlimited Favorites. We reorganize the sidebar so that Favorites are at the bottom. This means you can add as many favorites as you want without pushing important sidebar items off the screen.
April 28, 2022

Improved Cycles

We redesigned the Cycles screen. Each cycle now has a progress bar that shows a summary of the tasks inside the cycle.

It is now easier to add, rename, and reorder cycles using the new "Edit cycles" screen.

You can also open any cycle in a full screen view (previously only possible with the Active and Next cycles).

Fixes & Improvements

  • Fixed: The Active and Next cycle screens would sometimes appear empty because filters were applied from another view.
  • Fixed: An issue that caused older notes to not show in the notes feed.
  • Fixed: The Weekly appeared as "Untitled" in Favorites & Recents.
  • Fixed: The Weekly could be renamed, which should not be allowed.
  • Fixed: Contributors could update the base avatar or group cover photo even if they didn't have the correct permissions.
  • Fixed: Deleted notes were not removed from the Recents section in the sidebar
  • Fixed: When visiting a document via a direct link, the dropdown would not show under the document title.
  • Fixed: On task views, the "Order by" and "Group by" menus behaved unexpectedly.
April 15, 2022

Upgraded Notes

Notes provide a lightweight way to write something down and share it with the team. As we've observed contributors starting to organize their base into groups, we see that Notes are playing a larger role in the base. Notes are being shared & used to collaborate amongst teams and with external collaborators. We're giving Notes a refresh in this update. This way they can play a larger role in helping contributors capture and collaborate on documents to support their work.

Note Titles

You can now add a title to any note in Clarity! This lets you quickly search for notes by their title and easily find them in your Recents, Favorites and Pinned sections as well.

Cleaner Notes

When writing, we want as few distractions as possible. That's why we've simplified the appearance of a note while you're writing in it.

April 15, 2022

New Ways to Create Documents

We've decentralized the "Add New" button to provide more context for when to use each type of document. This also helps with creating notes in specific groups (and will apply to tasks when we roll our Group Work in Phase 4).

You can create new documents by clicking the "+" button on each item of the sidebar.

Each screen in the app also has a button in the top right corner for creating new documents. For example: "+ Note", "+ Wiki Page", "+ View", etc

April 14, 2022

Recent Documents

Recently opened documents are listed in the Search sidebar, but this means they're not as accessible or obvious as they should be. Now, the six documents you've viewed most recently are displayed in the sidebar where you can easily get back to them. This is similar to having papers on your desk that you've picked up recently. It keeps things "at arms reach".

April 14, 2022

Group Profiles

We rolled out Groups with Phase 1 of Clarity 2.0. We've since made some improvements to the experience. In your Group Profile, you can now seamlessly create sections, insert links, and reorder all sections & links to make the profile your own. You can now edit your group’s cover photo directly on the profile by clicking Edit in the top bar.

Easily create a new group from the Groups screen. You can view Groups using the More menu in the sidebar.

Fixes & Improvements

  • Remove a group cover photo. To remove your group's cover photo, enter edit mode in the Group Profile and hover over the cover photo. Click the trash button in the top right corner of the photo to remove it, and then click 'Done' to save your changes.
  • Unarchive a group. You can now easily unarchive any group by heading to the Groups screen from the sidebar.
  • Updated New Task Modal. We updated the style of the new task modal to be more compact and clean.
  • Previously, if a task or project card included many tags, they would overlap in the Kanban view. We now improved the appearance of cards in this view and tags should no longer overlap.