Files and images
Attach files to items, choose covers, and set board backgrounds.
Attach files to an item
- Drag files from your computer onto an item on the board.
- Or open the item, go to Files, and drop, choose or paste files there.
Each file can be up to 25 MB on Free, up to 2 GB on Pro and up to 5 GB on a team's boards: images, PDFs, office documents, text, archives, audio and video. The plan of the board's owner decides, so a guest can add files as large as the owner's plan allows. A file that is too large is refused before it is sent, with its size and the size the plan allows.
Large files
While a file uploads, Files shows how far it is. A file over 64 MB is sent in parts. When the connection drops, only the part that was under way is sent again, as soon as the connection is back. When you close the page or the browser stops, the upload is listed under Unfinished uploads on the item: add the same file to the same item again (Continue), and it goes on from where it stopped. This works in the same browser, for 20 hours. Discard gives the upload up.
Images also go straight into a description or a comment: paste or drop them while you write, or use the image button in the comment's toolbar. A guest with Comment can add a screenshot to a comment too. A picture in a description or a comment can be up to 10 MB; add a bigger image as a file of the item. An avatar can be up to 5 MB. A board background can be up to 10 MB (a GIF 5 MB), and is made smaller when you upload it.
Storage
Files, pictures in descriptions and comments, board images and text count toward your plan's storage. Text means item descriptions, documents with every saved version (archived ones too), comments and checklist items: 1 GB on Free, 5 GB during the 14-day Pro trial and 50 GB on Pro. Settings, Plan and billing shows how much you use. When it is full, new files and saves that make text longer are refused with a message; nothing you stored is deleted. Text can also be saved at only about 64 MB an hour per account and 256 MB an hour per team, far more than normal use; a guest, and email coming into a board or Unsorted, each have 8 MB an hour; past that, the save is refused and says when to try again.
Archiving an item keeps its files, because you can bring the item back. View archived items, in the board's ⋯ menu, shows how many files each archived item has and how much space they take, and sorts by size. Delete permanently there removes the item for good, with its files. Only the board owner, and on a team board the team's owner and admins, can do that; everyone else can Restore items there. In Settings, Preferences, you can turn on Delete archived items after 90 days. It always keeps decisions.
Removing a file frees its space at once: removed files don't count toward your storage, up to your plan's storage. Removed files above that amount do count, until you delete them for good or the 30 days pass. See Remove a file below.
An agent on your computer, such as Claude Code, can attach files for you too. See Add files from your computer with your AI. In ChatGPT, put a file in the chat and ask ChatGPT to attach it to an item. An AI in a chat app, such as Claude or ChatGPT, can also write a document and attach it as a PDF or Word file.
Virus check
Every file added to an item is checked for viruses on our server, with ClamAV. The file is not sent to another company for this. The check usually takes a few seconds; the file shows Checking for viruses until it is done.
- Checking for viruses: you can open your own file at once. Others on the board can open it when the check is done.
- Not checked yet: the file could not be checked, for example a zip or document locked with a password, or the check is not available for a moment (it runs again by itself). Only the person who added it can open it.
- Not checked: too complex: the file is not too big, but what is inside it (many embedded parts, or content that unpacks to far more than the file itself) passed a limit of the virus check, so it could not be checked fully. The tooltip names the limit, for example MaxFiles or MaxScanSize. It does not run again by itself. Only the person who added it can open it.
- Blocked: virus found: nobody can open or download it, you included. The person who added it is told. The file stays on the item, marked as blocked, and is deleted after 30 days. You can remove it sooner.
- Not scanned: too large: the file is over 250 MB, too large for the virus check, so it is not checked. Everyone on the board can download it. Listspace asks first, saying it couldn't scan the file because it's too large, and the file downloads only after Download anyway. It never opens in Listspace itself. Download it only if you trust where it came from.
Files sent to a board by email count as added by the board owner. Files added before the check existed show Not checked yet until they have been checked, which happens by itself. Pictures you put in a description, a document or a comment (and the pictures in a Word file you open as a document) are checked too, in the background. They show at once and are never held back. If a virus is found, the picture is removed for everyone and the text says "Picture removed: a virus was found in it". Board backgrounds and avatars are not checked: only real JPEG, PNG, GIF and WebP images are accepted there, and they are only ever shown as pictures.
Who added a file
Under each file's name is its size, its type and when it was added, for example "39 KB · Word · Oct 9, 6:25 PM". When your AI or another app attached the file, the line ends with its name: "· via Claude Code". The file viewer shows the same line. Files you add yourself show nothing extra, and neither do files added before Listspace recorded this.
Versions of a file
When you have a newer draft of a file, such as version 0.2 of a contract, add it as a new version instead of a second file. In Files, use the Upload a new version button on the file and choose the new one. It becomes the current file, and the old one is kept as an older version.
Already attached both as separate files? Use Make it a version of... on the newer file and pick the older one. The newer file becomes the current file and the older one moves under it as its version, with its comments.
A file with older versions shows Versions (2) under it. Open the list to see each older version with its number, size, date and, when an AI added it, the name of that AI. From there you can open a version in the viewer, download it, Restore it as the current file, or remove it. Restoring deletes nothing: the file that was current becomes an older version.
- Comments and pins stay on the version they were written on, so a pin never lands on the wrong spot of a newer file.
- The item counts files, not versions: a contract with three versions is one file.
- Older versions count toward your storage until you remove the file.
- Removing a file removes its older versions with it, and restoring it brings them back.
Your AI can add a new version too: ask it to replace the file with its new draft. From the command line, npx listspace attach <item> <file> --new-version does the same for the file on the item with that name. If there is no file with that name, it adds the file as a new one and says so. If two current files share the name, it stops and lists them, and --version-of <attachment id> picks one. An AI that does not use the command line gives the id of the file it replaces. The same rules apply as in the app: it needs access to add files to the board, and the old file is kept as an older version.
Every file on a board
Files in the board's ⋯ menu lists every file on the board's items in one window, newest first. The entry shows how many there are, for example Files (23).
- Each file shows its item and list, its size, the day it was added, who added it, and a note when the virus check has not cleared it.
- Search by file name or item name, and sort by date, name, size or item. Long lists show 50 files a page.
- Click a file to open it in the viewer, or its item to open the item.
- Files on archived items are not in the list: find them under Archived items. Files you removed are under Removed files.
- The list holds only the files you can open on their items.
Remove a file
The bin button on a file removes it from the item. Nothing is deleted at once: the file goes to Removed files, in the board's ⋯ menu, with its older versions and the comments on it. It stays there for 30 days, then it is deleted for good.
- On your own board you can remove any file. On a team board, the team's owners and admins can too. A team Editor or a guest with Edit removes only the files that person added. The bin button shows only on files you may remove.
- Removed files shows each removed file, its item, who removed it and when it is deleted for good. Only the board owner and, on a team board, the team's owners and admins see it.
- Restore puts the file back on its item, with its older versions and comments. When the item is archived, the file goes back on the archived item; find it under Archived items. When the item was deleted, its removed files went with it. Restore all brings back every file in the window.
- Delete now deletes the file for good at once; Delete all for good does that for every file in the window, after a question. Comments on a deleted file stay on the item, tagged "on a deleted file".
- Removed files don't count toward your storage, up to the size of your plan's storage. If more than that is in Removed files, the part above it counts, so a new upload can be refused until you use Delete now there or the 30 days pass. A restored file counts again, so when the storage is full, restoring is refused until there is room.
- Deleting an item deletes its removed files too.
- Your AI and other apps never remove files.
The cover
An item shows its first image as its cover, on the item in the list. In Files, point at another image and choose Use as cover, or choose Remove cover on the current one so the item shows no image.
Download all
Download all as zip gets the files of an item in one go, up to 100 MB together. With one file it says Download as zip.
View a file without downloading it
Select a file's name, or the eye button next to it, to open it in Listspace: PDFs, Word documents (.docx and .doc), spreadsheets (.xlsx, .xlsm, .xls and .ods), CSV and TSV files, markdown, Mermaid diagrams (.mmd), SVG images, and text or code files. A spreadsheet shows each sheet on its own tab, with the first 1,000 rows and 100 columns. Formulas and macros never run: a formula shows the result the file saved. An SVG shows as a picture, on a dark ground when the artwork is light, so a white logo stays visible. An SVG over 5 MB, or one with parts Listspace does not draw (such as embedded images, filters or links to other files), shows as code. Download always saves the SVG file itself. Files over 20 MB, and other kinds of files, are download only.
A Word document (.docx or .doc) shows with its page layout, as it looks in Word. Listspace makes a PDF of it on its own servers, which takes a minute or two after you add the file. Until then, and if the PDF cannot be made, a .docx shows the text of the document and a line that says so. A .doc has no text view, so it says it is being prepared and, if the PDF cannot be made, offers the download. The PDF is not a file of yours: it is not listed, it counts toward your storage like any file, and it goes when the Word file goes.
To work on a .docx or an old .doc in Listspace, open its ... menu in the Attached list and choose Open as a document. The same button is in the file viewer. Listspace makes a new document in the same list, directly below the item, with the same title as the file. A Word file that Listspace exported itself comes back as its content: without the cover and the back cover, and with the cover's title as the title. It brings over the text, headings, bold and italic, lists, tables, links and pictures, and puts a link back to the item on its first line. The document follows the Listspace style, not the Word layout. The Word file stays attached and keeps its layout preview, and a comment on the item links to the new document. Once it is a document you can edit it, keep its versions, comment on it, let your AI read it and export it. Up to 25 pictures come over; if there are more, Listspace says how many were left out. A Word file that makes more than 1 MB of text is not converted. Only people who can add items to the board see the entry.
An old .doc works the same way with one extra step. Listspace first makes a .docx from it on its own servers, which takes a minute or two, and the message says it is preparing the old Word file. That .docx is not a file of yours: it is not listed, it counts toward your storage like any file, and it goes when the .doc goes. It is made only when you choose Open as a document, and only once. If the .doc is damaged or password protected, Listspace says it could not be converted. Open it in Word, save it as a .docx and attach that file.
Other files open in your browser. None is sent to another service to be shown.
Your AI reads spreadsheets
Ask your AI about a spreadsheet on an item, such as a budget or a content calendar, and it can read it: each sheet as a table of text. This works for .xlsx, .xlsm, .xls and .ods files, and CSV and TSV files, up to 10 MB.
- Your AI reads the first 1,000 rows and 100 columns of each sheet, and 200,000 characters in all. It is told when something was left out.
- It gets the values as the sheet shows them. Formulas and macros never run.
- The file is read on Listspace's server, with the same rules as opening it: a file that is still being checked for viruses is read only for the person who added it, and a blocked file is never read.
- A spreadsheet is prepared in the background after you add it, which takes a minute or so. Until then your AI is told it is still being prepared and asks again in a moment. The original file stays as you added it. A copy of its text is kept with the file, is not shown in the app, does not count toward your storage, and goes when the file goes.
- If a file is damaged or too complex to prepare in 10 seconds, your AI is told it could not be read and gets the file's link instead, to open or download it.
- Other kinds of files are not read on the server: your AI gets the file's link instead.
Page through the files
The viewer pages through all of an item's files like an album, in the order the Files tab shows them: the images first, then the other files in the order you sorted them. Files you uploaded together stay in order by name, so 01, 02 and 03 come one after the other. Use the arrows on either side of the file, the left and right arrow keys, or swipe on a phone or tablet. The top of the viewer says where you are, for example "3 of 8". A file the viewer cannot show, such as a zip, shows its name and Download, and the next one is one tap away. Esc closes the viewer.
Comments on a file
Beside each file in the viewer (below it on a phone) are the comments on that file, with a box to add one. It works well for designs: share the board with a client as a guest with Comment, and the client leaves feedback on each design. In the item's Comments tab, these comments carry a small tag, for example "on homepage-v2.png", that opens the file. Files with comments show how many they have.
Removing a file hides its comments with it until it is restored. When a file is deleted for good, its comments stay, tagged "on a deleted file", so the feedback on an earlier version is not lost.
Pins on an image
On an image you can comment on one spot: click or tap it. A numbered pin appears there and the comment box opens; write your comment and press Comment. Nothing is saved until you do. Press Esc, or click somewhere else, to drop the pin. The pins stay on their spots at any size of the image.
Point at a pin or click it to find its comment, and the other way round. The eye button beside "Comments on this file" hides the pins or shows them again. A pin comment can be resolved: it then hides, with its pin, until you press Show resolved.
Without a mouse: Tab to the image (on a PDF, press C or the keyboard button beside the PDF first) and press Enter. The pin goes in the middle; the arrow keys move it (Shift moves it further), then Tab to the comment box.
Comments on a passage of a PDF
In the viewer, the text of a PDF can be selected. Select a sentence and a small Comment button appears beside it. Press it, and the comment is on that passage of that page. A single click on a page comments on that spot instead, with a pin, as on an image. The passage is marked on the page, and the comment shows its page and the quote. Click a quote to go to its passage, or a marked passage to find its comment. Passage comments can be resolved, like pins.
A PDF without text, such as a scanned page, says so. Click a spot of a page to comment on it instead: that works on every page of a PDF.
When a PDF is deleted for good, its comments stay, with their quotes and pages, tagged "on a deleted file".
Board backgrounds: Fill or Fit
In the board's ⋯ menu, choose Board settings. Background offers a color (one of ten, or any color you pick with the rainbow swatch or type as #rrggbb), a photo from Pexels, or your own image. For your own image, choose how it shows:
- Fill covers the whole board and may crop the edges. Best for photos.
- Fit shows the whole image, centered on a color you pick. Best for logos and graphics.
Large images are made smaller when you upload them, and transparency is kept. Photos look best at 1920 by 1080 pixels or larger.
Board avatar
Avatar in the same window adds a small square picture next to the board's name. The image is cropped to a square.