Artefacts & shared documents

Working in twelfth
twelfth AI & chats
Artefacts & shared documents

Artefacts (/app/artefacts) is one table of every file your workspace holds, wherever it arrived: documents you shared with twelfth, the spreadsheets and calendars linked as calendar sources, files attached in chat, Performance target workbooks and files kept with supplier notes. Search across all of them, filter by type with the chips above the table, and sort any column. A row opens the file: a shared document or target workbook in place, a chat attachment at the message it was said in, a calendar source in Settings → Calendars, a supplier file as a download.

To let the assistant know about a document, such as a range plan, supplier terms, a buying policy or a category review, you can upload it or link it.

Upload (or drop files anywhere on the page) to add a file from your computer: up to 10 files at a time, 10 MB each. An upload is kept as it is; re-upload to change it.

Link a file keeps a Google or Microsoft file current without uploading anything or setting up a sync:

In Google, share the Sheet, Doc, Slides or plain-text file with twelfth’s reader address (shown in the dialog) as Viewer. It is the same address Settings → Calendars uses.
Paste the file’s link. twelfth checks it as you paste (the file’s name and type, whether its contents can be read, and who in your workspace shared it) and shows the result before you add it. Choose whether it is for the whole workspace or one remit, and add a line about what it is for; the assistant reads that line to decide when the document is relevant.
twelfth reads the file and keeps a text snapshot. From then on the assistant knows about the document in conversations within its workspace or remit scope and reads it when a question bears on it, citing it by title.

The shared-document flow only reads; it never edits the document. Calendar and target templates, and spreadsheet destinations, have separate setup and writing rules. Google Sheets are read tab by tab; Docs and Slides as text; Word documents and PowerPoint decks as their text, tables included. PDFs and images are listed but cannot be read yet. Convert them to a Google Doc to include them.

A workspace admin can add a document for the whole workspace or any remit. A remit owner can add documents to their own remit. Everyone can read the workspace-wide documents and those in their remits, and refresh any document they can read.

Sharing a Google file with twelfth does not make it available to every
workspace. twelfth checks its owner and the person who shared it: an active
member with a verified email must vouch for it. A matching company email domain
or a pasted link alone does not qualify.

For a new file whose owner or sharer belongs to several workspaces, ask a
colleague who belongs only to the intended workspace to share it. Each file
stays bound to one workspace after unlinking; another workspace needs a
separate copy.

Access is checked again on reads and refreshes. If access is lost, the text
snapshot is cleared and Artefacts shows why. See
Google sharing and access.

A snapshot refreshes automatically when it is more than an hour old and the assistant reads it; open the document from the table and choose Refresh to read it again now. Very large files are capped, and the page says so. Remove takes the document out of twelfth; the file in Google is untouched.

The Updated column shows when the file itself last changed; under it, a linked file says when twelfth last read it.

Paste a OneDrive or SharePoint link into Link a file. There is nothing to share: twelfth reads it with your workspace’s connected Microsoft 365 account, once that account has granted access to files (Settings → Integrations → Microsoft 365). See Microsoft files as AI context for supported content and scope.

Using these files elsewhere

In a chat, the paperclip offers From Artefacts or a drive…: find a spreadsheet by name in Artefacts, Google Drive or OneDrive, and its biggest tab goes with your next message, as a file from your computer would.
On a new project, Attach artefacts ticks documents already here, takes uploads and drops, and on its Google Drive or OneDrive tab finds a sheet by name or takes a pasted link, linking it into Artefacts as it attaches.

Other files on the page

Linked calendar sources: the sheets and calendars read for your planning calendars. Managed in Settings → Calendars; listed here so a linked sheet can be found.
Files attached in chat: spreadsheets attached to a conversation. The rows live in the message; the card opens the turn they were said in. Visible to whoever can see the chat.
Screenshots: pictures sent to the assistant in a chat. The card opens the turn they were sent with. Visible to whoever can see the chat, which for a private chat is only you.
Note files: files dropped, pasted or attached into a supplier note or a project’s log, where they sit in the text as a small badge. Visible to whoever can read the note: the supplier within your remits, or a project you can see.
Target workbooks and Supplier note attachments: the Performance target uploads and the files kept with supplier notes, as before.

To manage company, category, remit or buyer targets, including ongoing sheet sync
and starter templates, use Sales and performance targets.