A board puts columns of cards inside a note, the way Notion and Trello do. Each card is a task, an idea or anything else that moves along: drag it from To do to Doing to Done, open it to write notes and comments, and give the cards properties of your own, like a due date or an owner. In a shared note, mention someone on a card and their phone tells them. The same cards can also be shown as the rows of a table, grouped by their Status or put in your own order, see Use table view.
Boards are on every plan, Free and Sync included, and work signed out too. Nothing on a board uses AI.
Adding a board to a note
Board view is in Beta, so it starts off. Turn it on first: open Settings, go to Note Apps and switch on Board view, the one with the Beta label. Until then the menus below do not offer it. See Choose which apps show in your notes.
Then open the note and put the cursor where the board should go.
- Slash menu, on desktop. Type
/on an empty line, thenboardif you like, and choose Board view. - Toolbar, on desktop. Open Apps in the toolbar and choose Board view, right after Diagram.
- Apps menu, on mobile. Tap the apps button, the four squares, in the bar at the bottom of the note or on the toolbar above the keyboard, and choose Board view, right after Diagram.
There is nothing else to set up. A new board lands in the note at once, named Board, with three empty columns: To do, Doing and Done. A note can hold as many boards as you like. Boards already in your notes keep working whatever the switch says, so turning Board view off only takes it out of the menus.
On Plus, Pro and Lifetime, the AI chat can also make a board for you, cards and all, from what you ask or from your notes, and change one when you ask.
The board in the note
The board sits in the note itself, between your paragraphs, rather than behind a card you open.
- On desktop it has no border round it, so its columns get the whole width of the note. Over them stand its icon and its name. Click the name to rename the board, and click the icon to give it another look, see Its icon and color below. The arrows at the end of the row open the board big. The dots beside them hold Layout, which shows the board as a table and back, Import CSV on an empty board, which brings a file's rows in as cards, or Export CSV on one with cards, which saves them as a file, and Delete, which asks first and then takes the board out of the note. Undo brings it back.
- On mobile the same board stands in the note, its columns running to the edges of the screen. Swipe sideways to go along them. Tap a card to open it, hold one to pick it up, and tap the arrows to open the whole board on a screen of its own.
A column in the note shows its first 8 cards, so a long board never makes the note slow or endless to scroll past. When a column holds more, a line like 12 more stands under its cards: choose it and the board opens big at that column.
Its icon and color
A board's icon stands before its name, on the board's color. On desktop, click it, in the note or with the board open big, and a picker opens under it: the 20 colors on top, then two tabs, Icons with 100 icons and Emojis with 100 emojis, ten to a row. Picking an icon or an emoji closes it. Picking a color leaves it open, so you can try another. An icon is white on the board's color, and an emoji sits on a soft tint of it.
On the phone, tap the icon, in the note or with the board open on its own screen, and a sheet opens with the same picker. It closes the same way.
It is the picker folders use too, so a board can match the folder it sits in, and prompts pick from the same icons and emojis. The icon and the color belong to the board, so they sync with the note, and everyone in a shared note sees them.
Adding cards
Add card sits at the bottom of every column. Choose it and type the card's title. Return, or the button at the end of the box, adds the card and leaves the box open for the next one. Clicking anywhere else adds what you typed and closes the box, and on desktop Escape closes it without adding. In a shared note, @ in the title brings up the people the note is shared with, see Mentioning people below.
Add column, after the last column, adds a column called New column in a color of its own. Click its name to give it a better one. A board holds up to 30 columns and 1,000 cards.
Moving cards and columns
Drag a card to move it, up or down its column or into another one. On the phone, hold the card until it lifts, then drag it.
Columns move by their header. On desktop the pointer turns into a hand round the column's name: press there and drag the column to its new place. Clicking the name itself renames the column. On the phone, hold the header and drag, or tap it and choose Move left or Move right.
Tapping a column's header in the note on the phone opens its menu: Rename, Move left, Move right and Delete column. Rename asks for the new name in a small box. On the board's own screen, tap the column's name to type a new one where it stands.
To delete a column, right click its header on desktop, tap it in the note on the phone, or hold its tab on the board's own screen, and choose Delete column. Grape asks first and says how many cards go with it, since a column's cards are deleted with it. A board always keeps at least one column.
The last column counts as done. Whatever column stands at the end, To do, Doing and Done or columns of your own, a card in it is finished, so its dates are never shown as late.
Undoing a change
What you do on a board goes into the note's undo, in the order you did it with your typing: a card moved, renamed or deleted, a column added or moved, a value changed, a property added or changed, the layout switched, and in a table the rows grouped or a row moved. On desktop press โZ to take the last thing back and โงโZ or โY to put it back (Ctrl+Z and Ctrl+Shift+Z or Ctrl+Y on Windows and Linux), in the note, on the board, in its big dialog or in a card. On the phone use the undo and redo buttons at the top of the note. The board's own screen has none: a change made there is undone from the note once you go back, in the same order. Typing in one field comes back in one step, and a deleted card comes back with its notes, values and comments. A change someone else made since is never taken back: undo only puts back what you changed. In a note being typed in live with someone else, undo takes back the note's text only.
Opening it big
The arrows over the board open all of it in a bigger space. On desktop it opens in a dialog, its columns wider. On the phone it opens on a screen of its own, with a tab for each column along the top: swipe to go from one column to the next, or tap a tab to jump to it. Everything works there the same way as in the note, and what you change shows in the note at once.
There every card shows, and each column scrolls by itself. A column of hundreds of cards opens and scrolls as quickly as one of ten, since Grape only draws the cards near what you are looking at.
Opening a card
Click a card on desktop and it opens in a dialog of its own. Tap one on the phone and it opens in a sheet. Either way it holds:
- The title, which you change where it stands
- Status, the column the card is in, to move it to another one without dragging it
- The properties the board has, see below
- Notes, as long as you need
- Comments, each with its writer's name and the time, and a box at the bottom to add one
Delete card is behind the dots at the top.
On the phone, tap Status and a small sheet opens with the board's columns as pills, each in its color with a ring at its end. The card's own has its ring filled with a check. Tap one to move the card there, and the sheet closes. The box over them, Find or add a status, finds a column as you type. A name that is not there yet comes up as Create, which makes it a new column of the board and moves the card there. The new column goes in before the last one, so the last column still counts as done.
Properties
A new board has no properties, so its cards hold a title, notes and comments. Add the ones you want: open any card, choose Add a property and pick a type, and every card on the board gets it.
- Text for a word or two, like a client or a room
- Number for an amount, an estimate or a score
- Select for one choice from a list of your own, like a priority or a stage
- Multi-select for as many choices from that list as fit, like tags
- Date for when it is due
- Checkbox for a yes or no
- Person for the people it belongs to, picked from the people the note is shared with
- Files for documents, pictures and anything else that belongs with the card
- Link for a web address, like the page or the document the card is about
- Formula for a value worked out from the card's other properties, like a total or the days left
A new property is named after its type. Click the name on desktop, or tap it on the phone, to rename it where it stands. On desktop the x at the end of its row deletes it from every card, and on the phone holding the name gives Rename and Delete property. On both, every value starts at the same place after the names. On the phone, tapping a value opens a small sheet to change it, the same sheet a table's cell opens, with the property's name at its top. For a text, a number or a link the keyboard is up at once, ready to type. A Checkbox is a switch right on its row. The board's cards show what their properties hold: a date, a ticked box, a word or a number, the options picked as colored tags, a link's address, how many files a card holds, what a formula comes to, and the faces of the people picked. A date before today shows red, unless the card is in the last column. A board holds up to 30 properties.
Select and Multi-select options
A Select or Multi-select property starts with no options: you make them as you go. Open its value on a card and type a name. On desktop, Enter adds it as a new option and picks it, and the same box finds an option that is already there. On the phone, tap its value and a small sheet opens with the property's name at its top and the options as pills, each in its color with a ring at its end that fills with a check when the card holds it. Tap a pill to pick its option or to take it off. A Select's sheet closes as you pick, and a Multi-select's has All and Selected over its pills. The box over them, Find or add an option, finds one as you type. A name that is not there yet comes up as Create, which adds it as a new option and picks it, and Return does the same.
- Picking. A Select holds one option, and choosing the one it holds again clears it. A Multi-select holds as many as you like, each toggled on and off.
- Colors. Each new option takes the next of 8 colors. To change one, open the dots beside the option on desktop, or hold it on the phone, and pick another.
- Renaming and deleting. The same place renames an option or deletes it. A renamed option shows its new name on every card that holds it, and a deleted one leaves every card.
A property holds up to 100 options, and a card up to 20 of a Multi-select's.
Links
Type or paste the address. It can start with https:// or not: grape.cool opens as https://grape.cool. The arrow at the end of the row opens it in your browser, on the phone inside Grape. Only web pages open from a board, so an address that starts with anything other than http or https stays as words.
Files
Add files picks one file or several, from your computer or from Files on the phone, and puts them on the card with their names and sizes. A card holds up to 20 files in each Files property, each up to 99 MB.
- Opening. On desktop, click a file to open it in the app your computer uses for it. Documents, spreadsheets, presentations, PDFs, pictures, text, audio and video open this way. Anything else, like an app or a script, never opens from a board, since someone else may have put it there: its dots hold Save a copy, so you choose where it goes and what happens to it. On the phone, tap a file to see it in the system sheet, where you can also open it in another app or save it to Files.
- Removing. The dots beside a file on desktop, or holding it on the phone, hold Remove file.
- Syncing and sharing. The files travel with the board the way a note's attachments do. With sync on they reach your other devices and count toward your storage, and in a shared note everyone in it can open them. A file that has not reached this device yet says so, and it comes with the next sync.
Formulas
A Formula property works out a value for each card from the card's other properties. Open its value on any card and write the formula. It is the same on every card, and each card shows what it comes to there. Under the formula you see what it comes to on that card, or what is wrong with it, and the board's other properties: click or tap one to put it in.
A property is written as prop("Hours"). If you rename the property later, the formula follows. For example:
prop("Hours") * prop("Rate")for what a task costsdateBetween(prop("Due"), today(), "days")for the days leftif(prop("Approved"), "Ready", "Waiting")for a word from a checkboxcontains(prop("Tags"), "Urgent")for whether a card wears a tagprop("Client") + ": " + title()for words joined together
A formula can use:
- Numbers and words. Numbers, words in quotes, true and false, the operators
+-*/%and^, and+to join words. - Comparisons and logic.
==,!=,<,<=,>,>=,and,or,not,if(test, then, otherwise),ifs(test, value, test, value, otherwise)andtest ? then : otherwise.empty(value)is true when the value holds nothing. - Words.
concat(...),join(list, separator),length,contains(where, what),lower,upper,trim,substring(text, start, end),slice,split(text, separator),repeat(text, count),padStart,formatandtoNumber. With a pattern:replace(text, pattern, with)changes the first match andreplaceAllevery one,test(text, pattern)says whether it matches andmatch(text, pattern)lists the matches. - Lists.
[1, 2, 3]is a list.first,lastandat(list, place)take one item off it,sort,reverseanduniquegive it back in another order, andlength,contains,joinandslicework on lists too.map(list, formula),filter,find,someandeverywork the formula out for each item, which it reads ascurrent, andindexis its place. - Names of your own.
let(name, value, formula)andlets(name, value, name, value, formula)give a value a name to use in the formula. - Numbers.
round(number, places),floor,ceil,abs,sqrt,pow(number, power),min,max,sum,meanandmedian, andformatNumber(number, "usd", 2)for money, a percent or a number with commas. - Dates.
today(),dateAdd(date, count, "days"),dateSubtractanddateBetween(first, second, "days"), with days, weeks, months, quarters or years,formatDate(date, "MMMM D, YYYY"), andyear,month,datefor the day of the month,dayfor the day of the week, from Monday as 1 to Sunday as 7, andweek. - The card.
title(),column(),created()for the day it was made, anddone(), which is true in the last column.
A Select reads as its option's name, a Multi-select, a Person or a Files property as a list of names, and a checkbox as true or false. An empty value stays empty, so a card with no hours shows nothing rather than 0, and so does a division by zero. A formula can read another formula, but never itself. On the card, a number shows after the property's name, true shows as a ticked box, and false shows nothing.
Formulas from Notion, Airtable and others
A formula you used in Notion, Airtable, monday.com or ClickUp works on a board as it is. Paste it into a Formula property, and give your properties the names it uses, or change the names in it.
- Properties can be written as
prop("Name")the way Notion writes them,{Name}the way Airtable and monday.com do,field("Name")the way ClickUp does, or as a one-word name on its own. - The card itself.
prop("Name")or{Name}is the card's title andprop("Status")its column, unless a property has that name. - Functions work in capitals or lower case, and as Notion's methods:
prop("Tags").length()islength(prop("Tags")). Airtable's&joins words,=and<>compare, and its functions are there too, likeDATETIME_DIFF,DATEADD,DATETIME_FORMAT,CONCATENATE,SWITCH,LEFT,MID,FIND,SUBSTITUTE,REPT,WORKDAY_DIFF,WEEKDAY,WEEKNUM,ARRAYJOINandREGEX_REPLACE. So are monday.com'sDAYS,ADD_DAYSandFORMAT_DATE, and ClickUp'sDAYS. - Where the apps differ. Notion's
day()is the day of the week and Airtable'sDAY()in capitals the day of the month, so each gives what it gave there.replacewith three values follows Notion andREPLACEwith four follows Airtable. - What a board does not have. A board's dates are days, so
now()is today and an hour or a minute is 0. There are no relations or rollups to read. A pattern can't look ahead, look behind or refer back to a group, and a formula that does says so rather than giving a wrong answer.style()andlink()keep their words, without the color or the link.
Mentioning people
A board has no sharing of its own: it is shared with its note. Once the note is shared, everyone in it sees the board, and everyone who can edit it can move cards, comment and mention.
Type @ in a card's notes, in a comment or in Add card, and the people the note is shared with come up. Keep typing to narrow the list, and pick someone. Their phone tells them who mentioned them and on which card, and a tap opens the card. Picking someone in a Person property tells them too, that you assigned them a card. In Add card the mention stays in the title as words, like Fix the FAQ @Dana.
In a note nobody else is in, @ says to share the note first, since there is nobody to tell. People with Can view see the board and cannot change it.
When someone mentions you
A mention reaches your phone as a notification, even with Grape closed. It says who mentioned you, in a card, a comment or a Person property, with the card's title under it. The card's notes and comments never travel in the notification. Tap it to open the card.
To choose whether they come, open Settings on your phone, go to Notifications and switch Board mentions, next to Sharing invitations. See Get notified when the AI is done for the rest of the switches there.
What each plan gets
Boards, with their columns, cards, properties, notes and comments, are on every plan, Free and Sync included, and work signed out too. Mentions need a shared note, so they come with sharing, on the Sync, Plus and Pro plans.
Where a board lives
A board belongs to its note.
- It syncs across your devices, including through Dropbox and Google Drive. Changes made on two devices at once are merged card by card, so a card moved on your laptop and a comment written on your phone are both kept. In a shared note the same goes for everyone's changes.
- It goes along in backups, and shows in the note's version history, read only.
- Delete the note and the board goes to Recently Deleted with it, where you can bring both back.
- Exported as PDF, HTML or Markdown, a note writes its board as an outline: the board's name, then each column with the titles of its cards. In Word it is a line in brackets, see Export your notes.
- A note holding a board cannot be locked until you take the board out.
Delete the board from its dots, and its cards go with it.