Better Tasks
Manage Attio tasks with custom fields, saved views, statuses, comments, and recurring schedules.
Installation and setup
Better Tasks is generally available. Install the app through its setup page in Neon Deer. The app is available now through those installation links while Attio marketplace approval is pending.
You need a Neon Deer organization connected to Attio, access to the app, and an organization admin to complete setup. If the app is not available in your organization, contact us.
- Open Better Tasks in Neon Deer and follow its setup page.
- Connect Workspace access to the Attio workspace whose tasks you want to manage. This connection keeps tasks and related activity up to date.
- Follow the app-connection link into Attio and complete the connection there. The installed app is named Better Tasks in Attio. Return to Neon Deer and check that both connections are complete.
Use the setup page's installation and connection links rather than installing a different task app. See the shared connection guide if either connection needs attention.
Create a task or add existing tasks
Create a task in Better Tasks, with or without a related Attio record. An organization admin chooses whether Related records is required in Configuration. New organizations start with it optional; existing configurations keep it required until an admin changes it. A task already linked to records must keep at least one. Add a description, assignees, and a due date, then fill in any attributes configured for that task type.
A task without related records is still created as an Attio task, but has no Activity on a record timeline.
After setup, new Attio tasks are brought into Better Tasks automatically. Creating a task in Better Tasks also creates its native Attio task.
Tasks created before setup are not imported automatically. This lets you leave behind old migration tasks or work created by automations your team no longer uses. Use Import Attio tasks to select the tasks you want to keep, without recreating them. Search and filter by title, status, assignee, related record, or dates, then select individual tasks or all matching tasks. Sort the list to review it before importing. Already imported tasks stay visible but cannot be selected again. Review each result before repeating an import. Blank values take the task type's defaults, so check those defaults first. The updated import panel requires the latest Better Tasks app in Attio.
A renewal task might be linked to a company, assigned to its account manager, and include the renewal brief in its description. The task's extra attributes and discussion are managed in Neon Deer; the connected Attio task retains its assignees, due date, completion, and related records.
Plans and task creation
Free includes 20 new Better Tasks per month, up to 200 in total. Paid plans and the trial include unlimited task creation. Importing existing tasks from Attio does not use either allowance. Editing, completing, commenting, and syncing existing tasks continue when the creation allowance is used.
New tasks, subtasks, and the next occurrence of a repeating task count. Archived tasks still count toward the total; archiving does not return the allowance. Creation controls are disabled when the allowance is used, with a message explaining when the monthly allowance resets or how to upgrade. Existing tasks remain available.
If completing a repeating task cannot create its next occurrence because the allowance is used, upgrade, reopen the task, and complete it again to create the next occurrence.
Task types, attributes, and statuses
An organization admin configures task types, attributes, and statuses. A task type determines which attributes and statuses are available for that kind of work. For example, separate sales follow-ups from onboarding tasks without requiring both to use the same fields.
Custom attributes support text, numbers, dates, and Select options. A Select can allow several values, for example tags for the teams involved. Existing Tags attributes are now multi-value Select attributes; their options, defaults, and saved values are kept. Retired options remain on tasks that already use them. Use a select attribute for an approval decision or team, a number for an estimate, or a date for a milestone. You can configure defaults and make an attribute required where supported. These are Better Tasks attributes, not new custom fields on Attio's native task object. The built-in Title, Description, Due date, Assignees, Related records, Status, and Owner attributes keep their names; custom attributes can still be named for your process. New tasks need all required values. Existing tasks missing a newly required value can still be edited, but you cannot clear a required value they already hold.
Statuses can describe work in progress, rather than only whether it is complete. Configure statuses such as To do, In progress, Blocked, and Done, including which statuses count as completed and the default open and completed statuses for a task type.
Saved views
An admin can configure saved views with filters for task attributes, task type, or creation date. All conditions in a view must match. Save a view for work you regularly return to, such as onboarding tasks awaiting approval or sales follow-ups with a particular priority.
Use exclusions such as is not one of, does not contain, or does not link to when you want a view of tasks outside a group. Negated comparisons exclude empty values, including blank text and empty lists. Use is empty to find those tasks explicitly. Select, Owner, Assignees, and Number attributes offer is empty and is not empty. Status, Priority, Task type, and Repeat always hold a value and do not offer them.
Choose List, Board, or Comments for the saved view. Reorder views and set the organization's default with Set as default for everyone. Each member can choose Set as my default or Clear my default. A personal default takes precedence over the organization default; deleting a personal default falls back to the organization default, then to All tasks.
Board cards show attributes on separate lines, related records, assignees, due dates, comment counts, and checklist progress. Turn on Show days overdue in Board settings or the list's Columns options to show how late a task is; it starts off. Record names open their Attio records in a new tab. Use Shift-click to select a range in checkbox lists.
Use Has comments beside Assigned to me for quick filtering; Clear filters resets both.
In List, resize columns and change Owner or Assignees in place. New assignments use active Attio members. A teammate suspended after assignment keeps their existing tasks, and filters still let you find those tasks. Subtasks stay under their parents.
Descriptions and comments
Use the description for the brief someone needs to carry out the task. Add comments for updates and handoffs as the work progresses. The discussion stays with the Better Task, so a teammate can read the context before taking over.
Use the Comments layout to review discussions across tasks, search comments or task titles, and filter by author, date, or task details. Group by task to see each task's newest comment. Board cards show comment counts; List offers Last comment and Has comments. These layouts and the latest filter choices require the latest Better Tasks app version in Attio.
Task descriptions are also included in the connected Attio task's text alongside its name. Changes to that text in Attio are read back into Better Tasks. Custom attributes and comments remain additional Better Tasks detail; do not assume Attio has a matching native field for each one.
Repeating tasks
Choose an interval in days, weeks, or months and how the next due date should be calculated:
| Option | How the next due date is calculated | Example |
|---|---|---|
| On schedule | From the previous due date. A due date is required. | A renewal review every three months. |
| After it's completed | From the day the task was completed, using your organization's time zone, or UTC if no time zone is set. | A follow-up two weeks after the previous call. |
The next occurrence is created when you complete the current task. Reaching a due date alone does not create another occurrence. A monthly task on schedule keeps its day of the month, using the last day of a shorter month when necessary. Clear the repeat setting to stop repeating.
These options need the latest Better Tasks app version in Attio. If you cannot see the current options, check the installed app and its connection before creating replacement tasks.
Templates
An admin can prepare templates for repeated kinds of work. Choose the task type, then set the starting title, description, and attribute values. Use Start New task from this template to choose the template New task starts from.
Use Insert variable to include values such as the linked person's name, company, deal stage, due date, or the person creating the task. These values are filled when the task is created; they do not continually update afterward. A missing value is left blank. Set supported owner and assignee defaults explicitly; the former option to assign the linked record's owner is no longer available.
Create tasks for selected records
Choose Bulk create tasks, search for Attio records, and tick each result you want to include. The search stays open while you select records, and previously selected records stay ticked in later searches. Use Clear all to reset the selection. Create one task per record using task values or a template. Review each record's result before retrying a selection. A task created this way links to its own record.
Archive tasks
Archiving a Better Task deletes its linked Attio task and Activity. The archived copy stays in Better Tasks, but this action cannot be undone. The task shows as archived while the Attio deletions finish; they are retried if Attio is unavailable.
Archive or move open subtasks before archiving their parent in Better Tasks. A task whose creation in Attio was not confirmed must first be linked to its existing Attio task. Deleting a task directly in Attio archives it and its subtasks in Better Tasks.
This applies to tasks archived or deleted from this release onward. Tasks archived before the change retain their Attio task. Install the latest Better Tasks app for the updated confirmation text; an older app's wording does not change the deletion behavior.
What stays connected to Attio
Edits in Better Tasks are queued for synchronization with the connected Attio task right away. Assignees, due dates, completion, and related records stay connected. If the task's Activity needs repair, that does not hold up the task update. The Activity on a related record is a display copy. Deleting only that Activity causes it to be recreated. Edits made to the Activity are replaced on the task's next change; edit the Better Task or the Attio task instead. Better Tasks adds the descriptions, custom attributes, configured statuses, saved views, and discussion used to manage the work in Neon Deer.
Keep both workspace access and the app connection working. They serve different purposes: workspace access keeps changes synchronized, while the app connection lets the Attio app open and edit Better Tasks.
Use task Activities in workflows
A task linked to an Attio record creates an Activity carrying its Status, Priority, and custom attributes. A task without related records has no record-timeline Activity.
In an Attio workflow, choose Activity created for a new task Activity, or Activity updated for later changes. Select the Better Tasks activity type and, for an update, the attribute to watch. For example, watch Status, check whether the new value is your approval status, and send a Slack message to the person responsible. Activity updated does not fire for values first set during creation; use Activity created for that case.
Change the task in Better Tasks or its native Attio task. The Activity reflects the task; direct edits to it are replaced on the next task change. Activity triggers require a supported Attio plan. See Attio's workflow block reference for availability and trigger settings.
API and MCP
The Better Tasks API and its MCP actions are generally available on Paid and during an active trial. Create tasks directly, from templates, or for selected records; read comments, configure views, and review sync issues. An organization admin chooses the connection's permissions.
The task creation allowance and API access are separate: Free can use the app with its stated allowance, but API access needs Paid or the trial. Compare plans or follow the MCP setup guide.
Troubleshooting
A task or update has not appeared. Check both connections, then review the task's sync issue. Where versions conflict, compare the saved task and Attio task, then choose which values to keep. Activity values are no longer a sync-review source. If creating the Attio task was unconfirmed, follow the linking action rather than creating a replacement. Review the result before creating another task. Existing Attio tasks may need Import Attio tasks.
Task setup was removed in Attio. Follow Retry on the task when its setup or Activity type was deleted. This repairs the setup. A failed send offers Retry too; check the result before creating another task.
A task needs renaming. Rename a task that already exists in Attio from Attio. Other supported values can still be changed in Better Tasks.
A member is unavailable. New owners and assignees must be active Attio members. A suspended member already assigned remains on that task, but suspended defaults are left off newly created tasks.
A field or status is missing. Check the task type and its configured attributes and statuses. An organization admin can change that configuration.
The next repeating task has not appeared. Confirm that the current task was completed. For On schedule, also check that it had a due date.
Setup is unavailable. Ask an organization admin to check app access and the organization's plan, or contact us. Do not send API keys or customer task content with a support request.