An item is a single row on a board: one task, one deal, one ticket, one contact. It is the unit of work in Gript. This guide walks through opening an item, everything inside the detail panel, and the day-to-day moves (comments, reminders, sharing, pinning, archiving) explained simply, with no jargon.
1
What is an Item?
In plain English: the thing almost everything in Gript happens on.
All fields
Task, Overview
An item is a row on a board. Whatever the board tracks, each individual thing is an item, and almost everything you do in Gript happens on one.
A task
The everyday case: a piece of work with an owner and a date.
A bug
On a bug tracker, one report per row.
An applicant
On a hiring board, one person per row.
A deal
On a pipeline, one opportunity per row.
A ticket
On a support board, one customer request per row.
It holds your data
Columns on the row hold the status, owner, dates, numbers, and anything else you track.
It holds the conversation
Comments, @mentions, files, and email threads all live on the item, next to the work.
It has its own address
Every item has a stable link you can paste anywhere. Clicking it jumps straight to the item.
You do not need to learn every tab at once. Open an item, use the Overview tab, and everything else is there when you need it.
Two kinds of item: Task or Document
When you create an item, Gript first asks what kind you want. Both are rows on the same board; they just start you off differently.
Task · actionable item
The everyday item: a to-do, a bug, a deal, a ticket. You give it a name and can set a status, priority, and due date right away. This is the default choice.
Document · rich text doc
A rich text page that still lives as a row on the board: meeting notes, a spec, a brief. You give it a title, and the document editor opens straight after you create it so you can start writing.
1
Press N, or use Add new on a board, or New in the sidebar
N works anywhere in Gript and knows where you are.
2
Pick Task or Document, then type a title
Choose the board and the group it should live in at the same time.
3
Click Create task, or Create document
The button follows the choice you made. A Document opens in the editor; a Task drops straight onto the board.
Choosing Task or Document when you create an item
Create new item
2
Opening an Item
Three ways to open the same thing. They all show you the same content.
1
Click the row, card, or bar
Click the row in Table view, the card in Kanban, or the bar in Timeline. The item detail panel slides in from the right.
2
Click the expand icon
The expand icon at the start of a row opens the item in a centered modal instead of a side panel. Good when you want the item front and center.
3
Visit the direct link
Every item has a stable URL of the form /t/<taskId>, built from the item's visible task ID (for example PROD-42). Paste it in Slack, an email, or a notebook page. Clicking it opens the item in Gript. See the Deep Links section below.
However you open it, you see the same thing: a header (breadcrumb, Watch button, layout toggle, more menu) and a row of tabs.
3
The Item Detail Panel
This is the panel that opens when you click an item. Here is what you are looking at.
The item detail panel
Item · Overview tab
At the top of the panelWhat it is
BreadcrumbThe board name, the group name, and the item ID when you have switched that on.
WatchFollow the item, so its changes reach your notifications.
Layout toggleSide, Modal or Full, which is how much of the screen the panel takes.
More menuThe three-dots button, holding the rest of the item actions.
The tab rowDirectly under those. The tab area fills the rest of the panel.
The Watch button
Click Watch to follow an item you do not own. Once you are watching, the button reads Watching, and hovering it shows Unwatch to stop. Watching feeds the item's reminder rules, so you can be alerted about changes even if the item is not assigned to you.
The more menu
The three-dots button opens a menu with Copy link to item, Duplicate item, and Delete, plus two preferences: Auto-open on row click and Show item ID in breadcrumb. Moving an item to another board is done from the item's row right-click menu, not here. The item ID (for example PROD-42) can be clicked in the breadcrumb to copy it.
Side, Modal, or Full: the layout toggle
The panel has three display modes you can switch at any time from the toggle in the header. Your choice is remembered.
Side (Default)
Slides in from the right. Best for quick edits while you keep the board in view. Drag the left edge to resize it (380 to 860 px). The width is remembered per browser.
Modal
A centered popup over the board. Best when you want to focus on one item. It is resizable too: drag either edge and it grows evenly from both sides, staying centered. Its width is remembered separately from the side panel.
Full
Full-screen. Best for items with long descriptions, lots of files, or a busy conversation you want room to read.
Record layouts (set per board)
Separately from the display mode, each board picks a default record layout for how the Overview content is arranged. It is set in the board's layout settings, and there are three templates to choose from.
LayoutWhat it is
Single columnContent stacked top to bottom in one column. Good for items with long descriptions.
50 / 50 splitTwo equal columns. Good for items with many short fields, such as a CRM contact.
70 / 30 splitWide left column for the main content, narrow right column for metadata (status, owner, dates). Good for ticket-style items.
A worked example: a support board uses 70 / 30 (the ticket conversation is the focus, metadata sits on the side). A CRM contacts board uses 50 / 50 (many short fields like email, phone, company, role). A document board uses single column (the document is the main content).
The detail panel
Board, click a task
4
The Tabs
Seven tabs run across the top of every item. It always opens on Overview.
The tab row
Task, the tabs
TabWhat it contains
Overview (default)The description, all of the item's fields, and a checklist. Approvals live here too, through the Approval column. Subitems are not shown here: they appear as indented child rows under the item on the board.
CommentsComments, @mentions, rich text, and image and file attachments. On items shared with a client this tab becomes Messages.
FilesEvery file attached to this item, with version history.
EmailEmail threads linked to this item. Send and receive email, and meeting invites, right from the item.
RemindersPer-item alert rules: due date, staleness, and watching. Marked with a small bell icon.
RecurringA template for auto-creating repeat instances of this item on a schedule. Marked with a repeat icon.
ActivityA chronological change log: who changed what, and when.
You can move between tabs with the left and right arrow keys once a tab has focus. The order is fixed: Overview, Comments, Files, Email, Reminders, Recurring, Activity.
The Email tab: email and meeting invites
The Email tab keeps email threads about this item next to the work, and it can also send a calendar meeting invite straight from the item. Start a new invite and a composer opens right in the panel:
Composing a meeting invite from an item's Email tab
Item · Email tab
FieldWhat it does
AttendeesAdd required people or type any email address, and use "+ Add optional attendees" for optional ones. The footer counts attendees and how many are external.
WhenPick a date, a start and end time (or flip on All day), and a repeat option (it defaults to "Does not repeat").
WhereAdd a location, and toggle "Add online meeting" to attach a join link (added when you send from a connected calendar).
Reminder and statusSet a reminder (for example 15 min before) and whether the time shows as Busy or Free.
AgendaWrite the agenda in a rich-text editor. Use "Ask AI" to have Gript draft the agenda for you, then edit it. Click Send invite to send it.
Recipients get a real calendar invite and can RSVP. Their replies (Yes, No, Maybe) come back to the item, so the attendee list stays up to date without leaving Gript.
5
Subitems vs Checklist
Two ways to break an item into smaller pieces. Pick the right one.
Subitems
Child items nested under a parent, and full items in their own right: their own columns, assignees and tabs. They are simply grouped under the parent visually.
A checklist
A lightweight to-do list inside an item. No columns, no activity, no sharing.
Use a checklist when...Use subitems when...
The to-dos are short and tacticalEach child needs its own owner, due date, and status
You will not track time, share, or comment on them individuallyYou need to discuss or share children separately
You want the items hidden inside the parentYou want the children visible on the board
The list is private to whoever is doing the workMultiple people own different children
Working with subitems
1
Add one
Expand the parent row in Table view and click + Add subitem. Subitems appear as indented child rows under the parent on the board.
2
Paste a whole list at once
After clicking + Add subitem, paste a multi-line list (one name per line) into the name field. A preview opens showing every row, and confirming creates one subitem per line. Pasting rows copied from Excel or Google Sheets, including a header row, also maps the columns onto the board's matching columns.
3
Right-click for the full menu
Right-click a subitem (or use the three-dots button at the end of its row) for: Edit name, Convert to item (promote it to top-level in the same group), Duplicate (the copy lands as a sibling), Copy link, Share, Move to (re-nest it under a different parent, on any board), Pin to top, Pin to another board, and Delete.
4
Reorder or convert
Drag subitems within the parent to reorder them. You can also convert a top-level item into a subitem of another item via the item's right-click menu, Convert to subitem.
Subitems do not inherit the parent's columns. Each board sets its own subitem columns in Board settings › Subitem columns, so subitems can be lighter than parents. Display style (Tinted, Tree, Indent, or Miniboard) is also set per board.
The item checklist
1
Open the item and find Checklist on the Overview tab
It appears when you have edit access.
2
Click Add, and write the things to remember
Tick them off as you go.
3
Anyone with access to the item sees it
Use it for a quick list you do not want to turn into full child items.
6
Comments and @mentions
The item's conversation, right next to the work.
Comments live on the Comments tab. Anyone with access to the item can comment. The comment box supports:
Rich text
Bold, italic, lists, headings, code blocks, and links.
Images
Paste from clipboard, drag from your desktop, or use the toolbar button.
File attachments
Drag a file onto the comment box, or use the attachment button.
@mentions
Type @ and search for a person. The mention becomes a clickable name, and that person gets a notification.
Mentions and editsWhat happens
Mentioning someoneThey get an in-app notification, and an email too depending on their own preferences.
Editing a commentYou can edit your own.
Deleting a commentYou can delete your own; an administrator can delete anyone's. Deletion is permanent, so think before you click.
Deletion has no undo. Removing a comment is a hard delete with no recovery. If you only want to fix a typo, use edit, not delete.
The Comments tab
Task, Comments
7
The Activity Tab
A running record of everything that happened to the item.
The Activity tabWhat it holds
Every entry showsWho acted, what they changed, the old value and the new one, and when.
What is trackedStatus changes, field edits, assignments, uploads, comments, shares and linked items.
Blue dot
A field-change entry: a status, value, date, owner, or other field was edited.
Grey dot
A comment or view entry, so you can tell activity from field changes at a glance.
Note: the Activity tab is visible, but its backend is still being built out. It will be fully populated in an upcoming release.
The Activity tab
Task, Activity
8
Reminders
Per-item alert rules so nothing slips through.
The Reminders tab, marked with a bell, holds the alert rules for this item.
Ahead of a due date
Nudge yourself before the date arrives rather than after.
When it goes stale
Nothing has happened on the item for a while.
Anything you watch
A reminder about any item you are following.
Reminders you set fire at the time you picked, in your own timezone.
Watching feeds reminders. Click Watch in the header to follow an item you do not own. That way its reminder rules can alert you even though the item is not assigned to you.
The Reminders tab
Task, Reminders
9
Recurring Items
Set an item to recreate itself on a schedule.
The Recurring tab, marked with a repeat icon, turns an item into a template that creates a fresh copy on a schedule.
1
Pick a level
Year, Month, Week or Day.
2
Refine it
Weekdays, specific dates, month-end rules, and even several weeks or months at once.
3
Say when and where
The time of day each new item is created (08:00 by default, in your timezone) and the board or group it lands in.
Good uses
A weekly status report, a monthly invoice, a daily standup checklist, a quarterly review. Anything that comes back on a rhythm.
Manage the whole set
The Hub (topbar) has a Recurring overview listing every recurring item across your workspace, so you can pause, resume, or run one now without opening each item.
10
Sharing
Give one specific person access to one specific item, and nothing else.
Right-click the item's row and choose Share task (the detail panel's three-dots menu does not have a Share option). You can grant Viewer (read-only) or Editor (full edit) access to:
Share withWhat it does
A specific userThe most common case. Pick a person and choose Viewer or Editor.
An access groupShare with a whole group at once, for example a team or a department.
Everyone in the workspaceRarely useful. Usually you want a more specific share.
The recipient sees the item in their Shared with me section in the sidebar, and does not see the rest of the board.
A worked example: an internal board has 200 items, and one is about a customer escalation involving a partner agency. Share that single item with the agency contact as Editor. They see only that item, none of your other work.
11
Sharing a task with someone outside Gript
Creating an update request
Board, Create update request
Sharing with a colleague is one thing. Getting an answer out of a client or a supplier is another, and it has its own tool: an update request, which you can start from a single task, from a group, or from the board.
What an update request gives themAnd you
They seeOnly the fields you allow.
They sign inWith a code emailed to them, not a password.
What they changeWrites straight onto the task, with their name against it.
How you noticeA task somebody edited that way shows a small unseen-updates dot on its row.
Once a task is shared like that, its Comments tab becomes Messages and you can talk to them there, with your internal notes kept separate on the same screen.
Full detail in Sharing work with people outside Gript and Client messages.
12
Read State, Pinning, and Archive
Small housekeeping features that keep a busy board manageable.
Item read state
Read stateHow it works
The blue dotA small dot on the title of any item you have not opened since it last changed.
Clearing oneOpen the item.
Clearing the lotMark all as read, from the item menu.
Why it helpsOn a busy board, scan for the blue dots to find where there is news.
Pinning items
ActionWhat it does
Pin to topRight-click the item and choose Pin to top. It moves into a Pinned group (auto-created on the first pin) at the top of the current board.
Pin to another boardPins a copy of the item to a different board's Pinned group, without moving the original.
UnpinRestores the item to its original group and position. If it was a subitem before pinning, it goes back to its parent.
Archive
Archive hides an item from the board without deleting it, and it can be restored at any time from the board's archive view. Use it for completed or on-hold work you want to keep as a record but not look at every day.
Archive is not delete. Archiving keeps the item and all its history; it just tucks it out of sight. Deleting is permanent. When in doubt, archive.
13
Bulk Operations
Act on many items at once instead of one at a time.
Acting on several tasks at once
Board, tick some rows
Tick the checkbox on a row (and shift-click another to take everything between them) and a bar appears at the bottom of the board with the count and everything you can do to the whole selection at once.
ActionWhat it does
Set statusPick a value from the board own status options and every selected task takes it.
DuplicateCopies the selection, asking first whether to bring the assigned people and the subtasks along.
MoveSends them to another group, or another board entirely.
Shift datesMoves every date on the selection forward or back together, which is how you slip a whole phase by a week. Offered when the board has a Date or Timeline column.
Approve or rejectOffered when the board has an Approval column. Decides on the whole selection in one go and tells you how many went through.
Create update requestBuilds one external link covering exactly the tasks you ticked. See Sharing work with people outside Gript.
DeleteSends the selection to the Recycle Bin, where it can be restored.
Selection survives scrolling, so on a long board you can tick as you go down and act on the lot at the end.
14
Deep Links
Every item has a stable address you can paste anywhere.
Every item has a stable URL: /t/<taskId>, built from the item's visible task ID (for example /t/PROD-42). Paste it in Slack, a notebook page, or an email, and clicking it opens the item in Gript.
Two quick ways to grab a link: use Copy link to item in the item's more menu, or click the short task ID badge (for example PROD-42) on the row to copy the ID to your clipboard.
15
Common Questions
Quick answers to what people ask most.
What is the difference between an item and a subitem?
Both are full items with their own columns, assignees, and tabs. A subitem is simply nested under a parent item and grouped under it visually. Use Convert to item to promote a subitem to top-level, or Convert to subitem to nest a top-level item under another.
When should I use a checklist instead of subitems?
Use a checklist for a short, private list of to-dos you will not track, share, or comment on individually. Use subitems when each child needs its own owner, due date, or status, or when different people own different children and you want them visible on the board.
Why does the item ID no longer show in the breadcrumb?
By default the item ID (for example PROJ-42) is hidden in the detail panel breadcrumb. Turn it back on with Show item ID in breadcrumb in the panel's more menu (the three-dots button). The preference is remembered per browser.
What does the Watch button do?
It makes you a watcher of an item you do not own, so the item's reminder rules can alert you to changes. The button reads Watch, then Watching once you are following it; hover it to see Unwatch and stop.
The Activity tab looks empty. Is it broken?
No. The Activity tab is visible, but its backend is still being built out and will be fully populated in an upcoming release. Field changes will show a blue dot and comments a grey dot.
Can I resize the detail panel?
Yes. In Side mode, drag the left edge (380 to 860 px). In Modal mode, drag either edge and it grows evenly from both sides, staying centered. Side and Modal each remember their own width, per browser.
What is the difference between archiving and deleting an item?
Archiving soft-hides the item and keeps all its history; you can restore it any time from the board's archive view. Deleting is permanent. When in doubt, archive.
If I share one item, can the person see the rest of my board?
No. A share grants access to that one item only. The recipient sees it in their Shared with me section in the sidebar and nothing else from the board.
How do I select every item on a board at once?
Press Ctrl/Cmd+A. It selects every visible item across all groups, respecting the active filters, and is ignored while you are typing in a field. Pair it with Shift+Click for ranges and Ctrl/Cmd+Click to toggle single items.
Can I act on a lot of tasks at once?
Yes. Tick the rows and use the bar at the bottom: status, duplicate, move, shift every date together, approve or reject, create an external update link, or delete.
What is the small dot on a task row?
Somebody outside your workspace edited that task through an update request and you have not looked at it yet.
Why is my Comments tab called Messages?
Because that task is shared with somebody outside Gript. The tab then holds your internal notes and the conversation with them, side by side but never mixed. See Client messages.
