Artifacts on events

Artifacts are structured documents made of tiles (rich text, sections, goal lists, KPIs, charts, diagrams, images, embeds) attached to a cadence event. Each event can have one primary artifact (shown first) and any number of addendums.

Where to find them #

Open any event from Cadences and switch to the Artifact tab. The Artifact tab is available to everyone who can access that event.

Artifacts themselves are limited to the people on the meeting. Organizers, participants, viewers and editors can all read them; organizers, participants and editors can edit. The artifact's owner (usually whoever created it) can edit it too, even on a meeting where they're only a viewer. If you open the Artifact tab on an event you're not on, the tab says you don't have access to this event's artifacts instead of showing an empty page.

Adding an artifact #

An event with no artifact yet shows three ways to start one: Generate with AI, Templates, or Start from scratch (plus a one-click Create from “…” button when the cadence has a default template). Just opening the tab saves nothing.

• Generate with AI: Brev starts drafting on the click, in the docked chat panel, while the document builds live in the tab behind it; steer it from there. Creates the artifact right away, since there's somewhere for Brev to write. See Drafting an artifact with Brev below.
• Templates: pick from your saved templates, your organization's, or the Brev library. Also creates the artifact right away, before laying down the template's sections and tiles. See Creating an artifact from a template below.
• Start from scratch: opens a blank editor titled after the meeting, but creates nothing yet. Start typing in the placeholder to add a text section, or click + to pick another tile kind: sections, goal lists, KPIs, charts, and more. Adding content is what creates the artifact, so leaving it untouched never leaves an empty one behind. The artifact is saved under the title showing at the time (the meeting name, or whatever you renamed it to before adding content) so the name never changes behind you once it saves.

Once an event has any artifacts, the tab shows them as a grid, even a single one, as a one-card grid, rather than jumping straight into an editor. Click a card to open it, or click Create new to add another and choose Generate with AI, Start from template or From scratch. From scratch adds the new artifact right away and opens it. Either way you land in that artifact's editor, with a Back to artifacts button to return to the grid. The editor's header is the same one the artifact shows on its own page: the title, who's viewing right now (see Seeing who else is viewing below), whether your changes are saved, Present, Share (for anyone who can edit the artifact), and a ⋯ menu with the template actions and, when the Artifacts page is on for your organization, Open standalone. Under the title is when it was created and by whom (a teammate, or Operator when Brev drafted it).

To have Brev work on an artifact you already have, use Generate with AI in that card's ⋯ menu. It opens the artifact and points Brev at that one. It builds into it, or continues from what's already there, rather than adding another artifact next to it. Create new → Generate with AI is the opposite: it always starts a fresh artifact.

Seeing who else is viewing #

The artifact's header shows a stack of avatars for everyone who has the artifact open right now, you included, on its own page and on the event's Artifact tab. Each person gets their own ring color, and after four avatars the rest are counted as +N. Hover an avatar to see that person's profile card. Click the stack to open Currently viewing, the full list of people with the artifact open; click a name to open their profile. The stack updates live as people open and leave the artifact, and only people who can open the artifact appear in it.

Formatting text and links #

Select text in a rich-text tile and a small formatting bar appears above it: the paragraph or heading style, bold, italic, strikethrough, link, and bulleted or numbered lists. Typing a web address followed by a space turns it into a link on its own.

To add a link by hand, select the words you want to link, click the link button, type or paste the address and press Enter. You don't need to type https://: it's added for you.

Click a link you've already made and the same bar shows that link instead, with the address and four actions: Open link (opens it in a new tab), Copy link (puts the address on your clipboard), Edit link (opens the address for changing, pre-filled) and Remove link (keeps the words, drops the hyperlink). Clicking a link while you're editing moves your cursor into it rather than opening it, so you can always get at these; use Open link, or click the link on an artifact you're only viewing, to follow it.

Text you type immediately after a link is plain text. The link stops where its words stop, so you can keep writing at the end of a sentence without the rest of it becoming part of the link.

In comments, check-in notes and Brev's replies, a link to an artifact's own page shows as a chip with the artifact icon. Hover it to see the artifact's title, what it contains, who made it, when it was last updated and who it's shared with. Someone who can't open the artifact sees only the link's own words. A link to a comment on an artifact, or a full web address, stays an ordinary link.

Tile menu and reordering tiles #

Hover a tile to show its ⋯ menu. What it offers depends on the tile and on whether you can edit the artifact:

• Comment: start a comment thread on the whole tile (see Commenting on an artifact below).
• Chat about this, on charts, diagrams and HTML documents you can edit: ask Brev to change the tile (see Editing a single chart or diagram with Brev below).
• Edit, Edit chart data or Edit diagram source, on tiles that have settings or data you can edit: opens that tile's editor.
• Copy as text, on tiles that can be copied as text: copies the tile's content as formatted text you can paste anywhere, such as an email or a chat message. Anyone who can read the artifact can use it.
• Delete, for anyone who can edit the artifact: removes the tile. Charts, diagrams, images, embeds, HTML documents and goal filters always ask you to confirm. Text, sections, goal lists and KPI cards ask only when they have content. Single goal, KPI, action list and progress graph tiles go straight away, since they show live data you can add back.

If you can edit the artifact, you can reorder its tiles by dragging. Hover a tile and drag it by the grip that appears at its left edge. The tiles around it slide apart to show where it will land, right under your pointer; moving it into a different section or card shows a line there instead. Hovering the middle of a section outlines it, and dropping there puts the tile inside the section. A red line or outline means the tile can't go there (for example a full KPI card, or a section dropped into itself), and letting go leaves everything as it was. Individual goals and KPIs inside a goal list or KPI card have no grip: drag the goal or KPI itself. On a touch screen, press and hold, then drag. With a keyboard, focus the grip, press Space, move with the arrow keys, and press Space to drop (Escape cancels). People who can only read the artifact can't move tiles.

If a tile can't be displayed, it shows “This tile couldn't be shown.” in its place and the rest of the artifact keeps working. You can still delete that tile from its ⋯ menu.

Undoing a change #

If you can edit the artifact, press Cmd+Z (Mac) or Ctrl+Z (Windows) to undo your last change to it: moving, adding or deleting a tile, changing a tile's title or settings, or editing its text. Press Cmd+Shift+Z or Ctrl+Y to redo it. Undo steps back through your changes one at a time, and the result saves like any other edit.

• While you're typing in a tile, Cmd+Z and Ctrl+Z undo your typing inside that tile. Click outside the tile to undo the whole edit, or anything else.
• Undo only takes back your own changes, made since you opened the artifact. If a change to the same tile (for example, by someone else or Brev) has reached your screen since, your change can't be undone and you'll see a message saying so. When someone else saves to the artifact at the same moment you do, your undo history starts over.
• A deleted tile comes back with the same content in the same place, as a new tile: comments that were on it don't come back with it.
• Adding or deleting an HTML document or an artifact link can't be undone. Delete or add the artifact link again yourself instead.

Primary vs. addendum #

• Primary: the event's main artifact. An event has at most one; if two people add the first artifact at the same moment, one becomes the primary and the other lands as an addendum automatically.
• Addendum: additional artifacts in creation order. Add as many as the event needs.

Who can do what #

Event organizers and participants can create, edit, rename, and delete artifacts on events they're part of, as can anyone the host has added to the event as an editor. People added as read-only viewers can read artifacts but not change them, except the ones they created themselves: you can always edit and rename your own artifact, and delete it from its card's ⋯ menu on the Artifacts page or in the Artifact tab of any event you can open. Someone an artifact is shared with as an editor can edit, rename, delete, and share that artifact too, and while the artifact's meeting is locked only its host (and the artifact's owner) can edit it. Adding a new artifact to an event still needs edit access to the event. See Roles & permissions for the full access model.

Presenting an artifact #

Put an artifact on the big screen with Present: a full-screen view built for TVs and townhalls. You'll find the button next to the artifact's title once it has content, both on the event's Artifact tab and when the artifact is open on its own page. Presenting doesn't require edit access. Anyone who can open the artifact can present it (see Roles & permissions for who can open what).

• The whole artifact, sized for the room: the full artifact fills the width of the screen, scaled so it stays readable from the back of the room. Longer artifacts scroll.
• Navigate: scroll, or step a screenful at a time with the arrow keys, spacebar, or a presentation clicker.
• Display density: move the mouse to reveal the on-screen controls and pick Compact, Standard, or Comfortable: Compact fits more on screen, Comfortable makes everything larger. The choice is remembered on that device, handy for a TV that always presents the same way. The controls fade out on their own.
• Exit: press Esc or click the × in the top-right corner.

Deliverables drafted by Operator #

When you ask Operator to draft something during a chat (for example, turning an uploaded goals file into an organized structure), it can hand back a deliverable: a standalone artifact it assembles for you. It appears as a card under Operator's message with a View button, so you can see exactly what was created and where it's stored.

Click View to open the deliverable on its own page and read the full document. Operator-drafted deliverables are yours. They show up in your Artifacts list marked as created by Operator, and they aren't attached to any meeting unless you add them to one.

Notes vs. Artifacts #

An event keeps two separate tabs: the Agenda & Notes tab (the meeting's running notes) and the Artifact tab (these first-class artifacts). They are not copies of each other. Your notes are untouched, and new artifacts start empty. Use Notes for the meeting's running notes, and Artifacts for structured documents you want to name, organize, and keep alongside the event.

Drafting an artifact with Brev #

Click Generate with AI and Brev drafts the document for you. On an event's Artifact tab (empty, from a card's ⋯ menu, or via Create new from the artifacts grid), this opens the docked chat panel in the corner of the screen while the document builds live in the tab behind it. Brev starts by asking what you want, and nothing is written until you answer. For an empty artifact it asks what kind of document to create: say what it's for and who will read it, and Brev names the document from your answer and builds it. If your answer is too short to draft from (just “a report”), Brev asks one or two quick follow-up questions first, each with a default you can accept. From a card's ⋯ menu on an artifact that already has content, Brev asks what to do with it (fill in its sections, add to it, or change what's there). After that, use the chat panel to steer it (“make it shorter”, “add a risks section”). An empty artifact opened on its own page works the same way and offers the same three choices (Generate with AI, Templates, Start from scratch). In an empty artifact you already opened from an event's grid, the same button is labelled Ask Brev. If Brev is already drafting that artifact, the button reads Open chat and takes you back to that conversation instead of starting a second one, for as long as you stay on that browser tab. After a reload, or in another tab, Brev offers Generate with AI again, so check your recent chats first if you are not sure whether a draft is already running.

Brev names the document from your request as soon as you ask for a draft. Say “create an artifact tracking notes of our monthly reviews” and the title is set from that, even if you haven't shared the content yet. Brev only fills in a title while the document is blank or still uses the default “Untitled Artifact” placeholder. Once you've given it a name of your own, Brev leaves it alone.

While Brev writes the draft, it shows a live Composing … status that names the section it's working on and, on a multi-section draft, an n of N counter, so you can see it's making progress even before the first sections appear.

Charts whose numbers Brev has to look up (from your goals or the web) appear as a Generating chart… placeholder and fill in on their own a moment later, so the rest of the draft keeps building instead of waiting on them. If one is taking unusually long, the placeholder offers an Edit chart data button so you can fill or adjust it by hand. You can also edit any chart's data, or a diagram's Mermaid source, later from the tile's ⋯ menu (Edit chart data / Edit diagram source).

When an already-drafted artifact is added to a meeting, the other participants get a link as a direct message on every chat app your organization has connected (Slack, Teams, or both). It opens the meeting with its Artifact tab already selected. When the meeting starts and Brev's notetaker joins, it also posts that link in the in-call chat and re-sends it by DM, so everyone has the documents at hand. The direct messages follow each person's Meeting recap notification preference. Turning that off stops the DMs; the in-call chat post is visible to everyone in the meeting and isn't controlled per person. Private meetings only ever notify the host, and nothing is posted to their in-call chat. Generating an artifact directly on an event's Artifact tab doesn't send this notification. The artifact is already attached to that meeting the moment you click Generate, so there's no separate hand-off moment to notify on.

Editing a single chart or diagram with Brev #

You can also point Brev at one tile: pick Chart or Diagram from the tile picker, or choose Chat about this on an existing chart or diagram tile. Describe what you want and Brev edits that tile in place while a preview updates beside the chat.

You don't have to wait in the dialog. Once you've sent your request, click Continue in background (or just close the dialog) and Brev keeps working. The tile shows a Brev is working… badge on the artifact, updates on its own, and a small notification confirms when it's ready. If something goes wrong, the tile shows a Brev hit a problem badge instead. Click either badge to reopen the conversation right where it left off.

Occasionally a diagram can't be drawn, usually because its source has a syntax error. The tile says This diagram couldn't be drawn and, if you can edit the artifact, offers Fix with Brev to hand it straight to Brev for repair, or Edit source to correct it yourself.

Saving an artifact as a template #

Turn an artifact you like into a reusable template: open the ⋯ menu above the artifact and choose Save as template. Give the template a title (prefilled from the artifact) and an optional description, which takes the same formatting as an artifact's text (lists, a toolbar on selected text, emoji, and / to link a goal; no @ mentions) and shows formatted when someone applies the template. Then choose what it should include: Structure + content (the default) copies everything as-is (text, goals, KPIs, and filters), so it's ready to reuse, while Structure only saves just the headings and layout for the next person to fill in fresh.

A goal list copied this way keeps the goals it had, often from an earlier time period. When you edit a goal list or KPI card, the picker opens filtered to the current time period, and goals already picked that the filters hide are listed at the top under N selected, hidden by filters. Untick them, or click Remove all, to drop them. Any you leave ticked are saved with the tile.

By default a template you save is private to you. If you're an org admin or owner, you'll also see a Make available to everyone in the organization checkbox. Tick it to save a shared template that anyone in your org can apply. Org-wide templates appear in their own Organization group in the template picker, and only an admin can delete them.

Creating an artifact from a template #

When an event's artifact is still empty, the Templates button opens the picker so you can start from any template. If the cadence has a default template set, you'll also see a one-click Create from “…” button. Applying a template lays down its sections and tiles; goal and KPI tiles point at live data, and anything the template left empty is ready for you to fill in.

The picker groups templates into My templates, Organization, and the Brev library. To remove one, hover it and click the trash icon, then confirm. You can delete your own templates; deleting an org-wide template requires an org admin, and the Brev library can't be deleted.

Saving a template never changes the artifact itself. Anyone who can open an artifact can save it as a template. The Save as template action appears in the ⋯ menu once the artifact has at least one tile.

Updating a template you started from #

If you created an artifact from a template and then improved it, you can push those improvements back instead of saving a second, near-identical template. Open the ⋯ menu and choose Update template. It appears only on an artifact that was created from a template that still exists, and it replaces that template's content with what the artifact holds now. You get the same Structure + content or Structure only choice as when saving a new one.

Artifacts already created from the template keep exactly what they have: only future uses of the template start from the new version. You can update your own templates; updating an org-wide template requires an org admin or owner, and templates in the Brev library can't be updated. If you don't have the rights, Brev tells you rather than silently doing nothing.

AI-generated HTML documents #

AI assistants connected to Brev (such as Claude Cowork) can publish interactive HTML documents (reports, dashboards, one-pagers) directly into your Artifacts. Each document appears as a full-width tile marked "Generated by Brev" and runs in an isolated sandbox: it can't read your Brev session, other tiles, or send data anywhere.

Published documents start private to you. An artifact can hold up to 10 HTML documents alongside regular tiles, and a document's content can't be edited in place. Ask the assistant to publish a corrected version and delete the old tile.

Sharing an artifact #

Artifacts you own start Private: visible to you and to participants of any linked event. Click Share in the artifact's header, on its own page or on the event's Artifact tab, to open the share dialog, the same one used for views.

• Invite specific people or teams: search for a teammate or team and add them, and the artifact shows up on their Artifacts page. Everyone you invite starts as a Commenter. To change what someone can do, open the menu next to their name under People with access and pick a role: a Viewer can read the artifact and its comments but can't comment, reply, or react; a Commenter can also comment; an Editor can also change the content and who it's shared with. Someone who can comment another way, such as through a team, a linked meeting, or org-wide access, keeps that.
• Share with your whole organization: under General access, switch from Invited users to Anyone at <your organization's name> so every member can view and comment on it. Switch back to Invited users to make it private again. The people and teams you invited keep their access, and their roles, either way, and you can keep inviting people while it's shared with everyone.
• Copy link: grab a direct link to the artifact to paste into a message.

The artifact's owner and anyone who can edit it can change sharing: editors invited here and editors on a linked meeting can invite people, change roles, and switch General access. Viewers can't, and AI assistants can never share on your behalf. Removing someone takes away their edit access too.

An @mention in an artifact only notifies people who can open it. If you mention a teammate who can't, they get no notification and no preview of the content, and you see a note naming them. If you can edit the artifact, the note has a Share button that opens the share dialog with them already added; once you share it, they get the mention notification, from you. Making the artifact org-wide does the same for everyone you mentioned. On a meeting's artifact, the people who can open the meeting are notified, which on a private meeting means its host and any admins who attended.

Commenting on an artifact #

Anyone who can open an artifact can read its comments. Everyone who can open it can also comment, reply, and react, except people it's shared with as a Viewer and who can't comment another way (through a team, a linked meeting, or org-wide access): they see a note in the comments panel saying they can view comments but not add them. Comments never change the artifact itself, so commenting can't clash with someone's edits.

• Comment on text: select text in a text tile and click Comment in the toolbar that appears above the selection (below it on a phone). If you can edit the tile, it sits at the end of the formatting toolbar. Your new comment opens beside the text, ready to type in, and the page scrolls just enough to show it if it would land below the bottom of the screen. The text stays highlighted while you write.
• Comment on a whole tile: hover a tile and click its comment icon, or open its ⋯ menu and choose Comment. This works for every kind of tile, including charts and HTML documents.
• See every thread: the Comments button (the speech bubble) in the artifact's header shows how many threads are open and opens the comments column beside the artifact. Each open thread sits level with the text or tile it's about and scrolls with the page. Click a thread, a highlight, or a tile's comment count to open that thread: its card is raised and nudged toward the text with its replies and a reply box, its highlight turns darker and underlined (or its tile gets an outline and a filled comment button), and the other cards slide aside to make room. Click anywhere else in the artifact, or press Esc in the comments column, to close it again. Use the filter icon at the top of the column to switch between Open and Resolved threads; a dot on the icon means you're looking at resolved ones, which show as a plain list, as do all comments on a phone.
• Reply and mention: reply to any thread, and type @ to mention a teammate. They get an inbox notification that opens the artifact on that thread. Only people who can open the artifact are notified: if you mention someone who can't, you'll see a note saying so.
• Edit your comment: open the ⋯ menu on a comment or reply you wrote and choose Edit comment. Change the text, then press Enter or click the send button to save; press Esc or click Cancel to keep the original. An edited comment shows (edited) after its time. Only the person who wrote a comment can edit it. If your edit @mentions someone new, they're notified; people the comment already mentioned aren't notified again.
• Resolve and delete: whoever started a thread, or anyone who can edit the artifact, can resolve it with the check icon at the thread's top right, and reopen it the same way. Resolving removes its highlight and tile count, and the thread moves under Resolved. To delete one of your own comments, open its ⋯ menu and choose Delete comment. A thread whose first comment was deleted keeps its replies and can still be resolved, but takes no new replies.
• React to a comment: hover any comment or reply and click the smiley icon, then pick an emoji. Reactions show as small counts under the comment; click one to add or remove your own, and hover it to see who reacted. Reactions don't notify anyone, and a deleted comment can't take them.
• Share a thread: open the ⋯ menu on a thread's first comment and choose Copy link. The link opens the artifact on that thread. Copied from a meeting's Artifact tab, it opens there.

If the text a comment was about is edited away, or its tile is removed, the thread stays in the panel under Original content changed, with the text it was about. You can still reply to it and resolve it. A tile you've just added can take comments once it has saved, and while Brev is building the artifact you can read comments but not start new ones.

Link previews in chat apps #

When you paste an artifact link into Slack, Microsoft Teams, WhatsApp, iMessage, Discord, and similar apps, the message unfurls into a preview card. What the card shows follows the artifact's sharing setting: artifacts shared with Anyone at <your organization's name> preview with their title, tile count, and last-updated date; Private and invited-only artifacts show a generic "Artifact on Brev" card instead, so the title is never revealed outside the artifact's audience.

Preview cards never include artifact content. Opening the link always requires signing in to Brev.

When the latest changes don't load #

An open artifact picks up new edits on its own, whether Brev or someone else made them. If loading the newest version fails, the artifact you have open stays on screen. On its own page you'll see Couldn't load the latest changes. Showing the last loaded version. with a Retry button. If an artifact can't load at all when you first open it, the page says so and offers Retry as well.

Deleting an artifact #

Hover the artifact's card, open its ⋯ menu and choose Delete, then confirm. Cards with Delete are on the event's Artifact tab and on the Artifacts page (the artifact's own page has no Delete), and the artifact disappears from both immediately. An administrator can recover it within 90 days, after which it becomes eligible for permanent removal.