Items and documents
Items are tasks, ideas and notes. Documents are longer texts with versions.
Everything in a list is an item or a document. Both open in the same window.
Add one
Choose Add at the bottom of a list: a new item opens, ready for its title. Press Enter to save it and open the next one, or Esc on an empty title to cancel. Adding a file, a checklist or a comment saves the item first, in the same window. That makes an item: a task, idea or note, with checklists, labels and dates.
A document is a longer text with versions, like a spec or a brief. Add it as an item, open it and choose More at the bottom of its window, then Make it a document. Make it an item turns it back.
Share to Listspace from your phone
On an Android phone, Listspace can sit in the share menu next to your other apps. Share a web page, some text, photos or a PDF from any app, and it becomes an item.
Install Listspace once
In Chrome, Edge or Samsung Internet, open listspace.app and sign in. Open the browser menu and choose Install app or Add to Home screen. Listspace now has its own icon, and shows in the share menu.
Share something
- In any app, tap Share and pick Listspace. The first time, you may need to tap More to find it.
- Add to Listspace opens with what you shared: the title (the page title, or the first line of the text), the link with a preview of the page, the rest of the text as a note, and the photos and PDFs.
- Change the title or the note if you like. Tap the X on a file to leave it out.
- Under Save to, keep Unsorted or pick a board, then its list.
- Tap Save.
Signed out? Listspace asks you to sign in first, then shows the same screen. What you shared waits on the phone until you save it or tap Discard.
Files need a board
Photos (JPEG, PNG, GIF, WebP) and PDFs can come along, at most 10 MB each and up to 10 per share. Unsorted cannot hold files, so to keep them, pick a board. Or remove the files and save the rest to Unsorted.
iPhone and iPad
iPhone and iPad do not let web apps join the share menu, so Listspace does not show there, even when it is on your Home Screen.
What an item holds
Click an item to open it. An item with a description opens in read mode, to read it as it is. To change it, choose Edit, or click the title or the text: the editor opens with the cursor where you clicked. Links still open, and selecting text does not switch to editing. An empty item opens ready to type. When you can comment, read mode shows the comments with a box to add one under them, so you can comment without choosing Edit. A document shows them under its text; the comments on its passages stay beside it. A comment you have not sent yet is kept on this device and shows Not sent yet until you send it or clear the box. A link to a comment, from a mention email or For you, opens the item at that comment. Read mode always shows an item's due date. Without one, click Add due date and pick the day; Remind me and Repeat then show under it. In edit mode, Save changes saves the title and the description, and the eye button (Read mode) goes back to reading. Esc does the same: it saves your changes and goes back to read mode, and Esc in read mode closes the item. If the save fails, the item stays in edit mode with the error, so nothing you typed is lost. Markdown shortcuts work in the editor, and you can paste images into it.
In edit mode the window has tabs:
- Details: the title, a due date, Remind me (your own reminder before the due date, in the daily summary; see Boards), the labels (colored tags to sort and filter items by), and a description with headings, lists, tables, code and images. Once there is a due date, Repeat sits under Remind me (see below). The board's fields show too, one row each, with or without a value (see Custom fields). Everything else waits in Add to item: a start date, a time, a dependency, a sub-item, a checklist and a link. Pick one and it shows, ready to fill in. A part with a value always shows, so a new item stays short and a busy one shows all it has.
- Files: the item's files. See Files and images.
- Checklists: one or more lists of steps to tick off. You can also tick a step in read mode, with one click or Space, without opening edit mode.
- Comments: notes from you or an agent, with who wrote them. Sort shows them Oldest first or Newest first; this device remembers your choice. A document has no Comments tab: its comments are in the column beside its text (see below).
- History: every change, and who made it, you or an agent. On Free it shows the last 30 days.
On a wide screen (1024 pixels or more) an item opens in two columns: the title, the description, the checklists and the comments on the left, and the properties on the right (the dates, labels, fields, links and dependencies). The right column stays in view as you scroll. In edit mode, Details then holds the checklists and the comments, so the window has no Checklists or Comments tab: add a checklist, tick a step or reply right there. A document opens with its title and text on the left and one panel on the right, with a switch at its top: Comments (the default) shows its comments, Details shows the same properties as an item. Listspace remembers your choice on this device.
To go to the next or previous item without closing the window, use < and > in the title bar, next to the item's place, such as 4 of 14, or the left and right arrow keys. On a phone or a tablet, swipe left for the next item and right for the previous one. The order is the board's, list by list, from top to bottom. Your changes are saved before the next item opens.
On the board, an item shows how many files, links and comments it has. Click the paperclip count to open the item on Files, or the comment count to open it in read mode at its comments.
Web and email addresses in a description or comment become links as you type or paste them, like example.com/page or name@example.com. Links open in a new tab. Text inside code stays as it is.
A code block marked mermaid (three backticks, then mermaid) shows as a diagram when you read an item, a document, a comment or a shared board. In edit mode, click in a code block and pick Mermaid diagram under Language to make it a diagram, or another language to show it as code. The editor keeps the code. Print or save as PDF prints the diagrams, and Word (.docx) puts them in the file as pictures. A diagram that cannot be drawn stays as code in both. An attached .mmd or .mermaid file opens as its diagram, with View source for the code. See Mermaid diagrams.
Repeating due dates
Some work comes back: a subscription that renews every month or year, a monthly report, a weekly check. Give the item a due date, and Repeat shows under Remind me in the item window. Pick how often it comes back: every day, week, 2 weeks, month, 3 months or year, or Custom for any number of days, weeks, months or years. The item shows a small repeat icon next to its date on the board.
When you mark a repeating item done, it is not finished. It stays in its list, its due date moves to the next time it is due, and the done tick clears, so it is ready for next time. A start date moves along with it, and its checklists start unticked again. This happens however it is marked done: Mark done, the Done box, the table, an agent, or dragging it to a Done list (it stays where it was). The history says what happened, for example "Marked done for Oct 1; next due Nov 1", and Undo puts the dates back.
Was it overdue by more than one round? The due date skips ahead to the first one after today. Every month from the 31st falls on the last day of shorter months and on the 31st again when the month has one; every year from 29 February falls on 28 February in other years.
To stop, choose Does not repeat under Repeat. Removing the due date stops it too. The calendar view and the calendar feed show the next due date only.
Assign people
Assign people to an item to say whose work it is. In the item's window, the Assigned row has one way to assign. When you are the only person on the board, it shows Assign to me, one click. Once the board has others, it shows Assign, a menu of everyone on the board (the owner, the team's members and the guests, you first): a click assigns or unassigns that person. An item can have up to 10 people.
- The item shows in each person's For you under Assigned to you, or under Overdue or Today when it is due.
- Each person gets an email, at most one every 30 minutes and not during that person's quiet hours (anything else waiting for that person comes in the same email), unless that person turned off Emails when someone mentions or assigns you in Settings, Notifications. With notifications on a phone or computer, a notification comes too, unless Mentions, requests and assignments is off. Assigning yourself sends no email or notification; your AI assigning you does. Assigned to the same item again within a day, nobody gets a second email or notification.
- On the board, the item shows the faces of the people assigned (three, then "+2" for more). Filter > Assigned to me shows only yours, and the table view has an Assigned column.
- The item's history says who assigned whom, and names your AI when it did.
- Someone who leaves the board is unassigned from its items.
The board owner, team members who edit and guests with Edit assign people. Guests with View or Comment see who is assigned, but do not assign anyone, not even themselves.
Your AI can assign people too, for example you, when it wants you to review something. It is a change to the item, so the Agent access you set decides: from Act it applies, below that it waits in your Inbox.
Links on an item
An item can hold links to where its work lives: a pull request, a design, a document or any web page. On the board the item shows only how many it has: a link mark and a number, with its other counts. Open the item to see them as small chips under Links, and click a chip to open the link in a new tab.
To add the first one, open the item and choose Add to item > Link, in read mode or in edit mode. After that, Add link sits next to the links. Paste the address, give it a label if you like, and choose Add link. Without a label, the chip is named from the address: PR #370 for a GitHub pull request, Issue #12 for an issue, or the site's name. The pencil changes a link and the cross removes it. An item holds up to 20 links.
A GitHub pull request or issue in a public repository also shows where it stands, checked every few minutes: open, draft, merged or closed, with a tick when its checks pass and a cross when one fails. Hover the chip for the repository and the title. A private repository shows the plain chip.
Agents add links too. Listspace asks an agent that opens a pull request for an item to add the link, so the board shows the work without anyone asking. With GitHub connected (see below), a pull request whose description has the item's address adds the link by itself. This applies from Capture in the board's agent access (see Inbox and agent access). A link cannot wait in the Inbox, so on a board set to Suggest or Read only agents cannot add one. Every change to the links is in the item's History and can be undone.
To keep items moving on their own, connect GitHub: Connect GitHub in Settings > Capture and connections opens GitHub, where you pick the repositories. Only the owner of a GitHub account, or an admin of a GitHub organization, can connect its installation. From then on, chips also show pull requests in those private repositories, and GitHub moves your items: when a pull request linked to an item opens, the item moves from To do to Doing; when it merges, the item moves to Done with the comment "Merged PR #n"; when it is closed without merging, the item gets a comment. A pull request whose description has the address of an item counts too, and the item gets the link. GitHub works like an agent on your boards, within each board's agent access: below Act its moves wait in the Inbox, and below Full a move into Done waits there too. Listspace only reads pull requests and checks in the repositories you pick. It cannot read your code or change anything on GitHub. To stop it, choose ... next to the account in Settings > Capture and connections, then Disconnect.
The state of pull requests in public repositories is part of Free and needs no connection. Connecting GitHub is part of Pro, the trial and Team included: it adds private repositories and items that move by themselves. On Free, Connect GitHub shows a Pro label and leads to Plan and billing. When Pro ends, the connection stays, but private states and the moves pause until you upgrade again.
Documents and versions
A document keeps a version each time it is saved. Saves by the same person, or by the same AI, within 10 minutes count as one version. In the History tab you can View an old version, Compare two of them, or Restore one. Restoring saves it as a new version, so nothing is lost.
The History tab lists the latest 50 versions. Older versions are not deleted: they move to an archive, and the tab says how many are there. Press Show to see them with their dates and authors, open one, or restore it like any other version. The archive counts toward your storage; Delete older versions frees it. If you do not want to keep it, choose ... in the History tab, then Delete older versions. After one confirmation, the archive of that document is deleted for good, and the History tab records who deleted how many versions. Only the board owner and team admins can do this. Your AI can read and restore archived versions, but never delete them. A copy of a document gets the latest 50 versions of the original, not its archive: the original keeps the archive. The eye button (Read mode) shows the document for reading: on a wide window, a table of contents made from its headings on the left (when it has three or more), the text in the middle and its comments on the right. The section you are reading is marked in the contents. On a narrower window, the Contents and Comments buttons at the top of the text open them.
Comments on a document
A document has one place for its comments: the Comments column beside the text, in read mode and while you edit it. On a wide screen it is the Comments tab of the panel beside the text; on a narrow window, the Comments button at the top of the text opens it. A link to a comment opens the document at it in this column. It lists every comment on the document, oldest first, with the box to write a new one at the bottom. What you write there is about the whole document.
To comment on part of the text, select it and press Quote selection under the box. The box then shows the quoted passage, and your comment is on that passage. Cancel takes the quote away, so the comment is about the whole document again. The passage is marked in the text. Click a marked passage to find its comment, or a comment's quote to find its passage. When a comment is dealt with, press Resolve: resolved comments are hidden, and Show resolved brings them back. Guests with Comment can do this too.
The marks are not part of the text, so comments never make a new version. When the text changes so the passage is gone, the comment stays, with "The text changed since" and the passage as it was.
Archive, move, copy and delete
Archive at the bottom of the item window hides the item from the board without deleting it. Alt Shift A does the same while the window is open. The message that follows has Undo, and archived items come back any time with View archived items in the board's ⋯ menu.
Next to it are Mark important (see For you), Mark done for an item with a due date in read mode, and, once someone else is on the board, Ask someone. Mark done marks the due date done and, when the board has a Done list, moves the item to the top of it. Changed your mind? The same button now says Mark not done and puts the item back where it was. An item that is already in a Done list has no Mark done: move it out to open it again. On a smaller window Archive and Mark important show as icons (hover one for its name), and Ask someone moves into More. On a narrow window all of these buttons are in More. More holds the rest: Move and Copy, to any list on any of your boards, Make it a document, Mark as decision (see Decisions), the export and Delete. A copy gets the title, description, dates, checklists, labels, field values, the sub-items that are not archived and, for a document, its versions. On another board it gets the values of the fields that board has too, with the same name and type. It does not get the files, links or comments. With a mouse you can also drag an item onto one of your other boards in the panel on the left: it goes to that board's first list that is not a Done list, and the message has Open and Undo. Delete removes the item for good. Only the board owner sees it, and on a team board the team's owner and admins too. Everyone else who edits the board archives instead.
Work on several items at once
Hover over an item and tick its checkbox. Shift-click another one to select everything in between. The bar at the bottom can then Move, Add label, Remove label, set a Due date, Archive or Delete them all. Delete is there only for the board owner and, on a team board, the team's owner and admins. Archived items come back with View archived items in the board's ⋯ menu.