What are issues?
Issues let you report problems, request changes, and track feedback on your models. Raise an issue from the 3D viewer and it stores the view you were looking at, so anyone who opens it sees the same thing. Assign it, set a priority and due date, and track it until it is resolved.
Create
Coordinate
Track
Create an issue in the viewer
Set up the view
Start a new issue
Fill in the issue
Create the issue
Can I create an issue without selecting an object?
Can I create an issue without selecting an object?
How do I mark up the model for an issue?
How do I mark up the model for an issue?
What if I need to reference multiple objects in one issue?
What if I need to reference multiple objects in one issue?
Issue fields
Each issue has fields to help you organize and prioritize work.
Title and description
The title is required. The description is optional plain text.Status
Track progress with three statuses:- Open - the issue needs attention (default)
- Ready for Review - the work is done and needs checking
- Resolved - the issue is closed
Assignee
Reviewers and higher roles can create issues, reply, and be assigned to issues. For a private project, an assignee must already have access to that project; ordinary workspace membership alone is not enough. Assigned users receive an email notification.Due date
Set a date when the issue should be resolved. Use the Overdue filter to find issues past their due date.Priority
Indicate urgency with four levels: No priority (default), Low, Medium, High.Labels
Tag an issue with one or more labels to group issues by discipline, phase, type, or any other criteria. Workspace admins manage labels in Workspace settings → Issue labels, and labels are shared across all projects in the workspace.Can I change fields after creating an issue?
Can I change fields after creating an issue?
What happens if I delete a label that's used on issues?
What happens if I delete a label that's used on issues?
Reply and attach files
Replies
Write a reply at the bottom of an issue, in the Issues panel or on the issue page. Press Cmd/Ctrl+Enter to send. Replies appear in order below the description. Anyone with the Reviewer project role or higher can reply.Attachments
- When you create an issue, select Attach file to add one file.
- On the issue page, attach a file to a reply with the paperclip.
Is there a file size limit for attachments?
Is there a file size limit for attachments?
Can I attach files from my desktop apps like Revit?
Can I attach files from my desktop apps like Revit?
What file types can I attach?
What file types can I attach?
Find and manage issues
Issues panel in the viewer

- Status
- Priority
- Assignee
- Labels
- Overdue
Can I see issues from multiple models at once?
Can I see issues from multiple models at once?
Why don't I see an issue I know exists?
Why don't I see an issue I know exists?
Why does an issue say its view can't be applied?
Why does an issue say its view can't be applied?
Issues page in the project

What's the difference between the Issues panel and the Issues page?
What's the difference between the Issues panel and the Issues page?
Can I export the issues list?
Can I export the issues list?
Issues in connectors
Issues are accessible directly in your desktop applications through Speckle connectors for Revit, Rhino, SketchUp, Navisworks, and other supported applications. When you load a model in a connector, you’ll see an issue icon with the count of open issues. Click it to view the full list of issues for that model, complete with all properties like labels, priority, and assignees. Click any issue to see the associated object highlighted in your host application. This lets you address problems without switching between your desktop app and the web interface.Can I create issues from the connector?
Can I create issues from the connector?
Can I reply to issues from the connector?
Can I reply to issues from the connector?
Can I resolve an issue from the connector?
Can I resolve an issue from the connector?
Will issues update in real-time in my desktop app?
Will issues update in real-time in my desktop app?
Issues in Speckle Intelligence

- Issues Overview combines issue trends, counts, and breakdowns.
- Issues list is a sortable, filterable table of issues with their replies.
Issues from Data Validation
Issues raised from a Data Validation result reference the objects that failed a rule and carry the Data Validation label. Opened in the viewer, they frame those objects with the rule as a filter. On the project’s Issues page, select Open in check results to go back to the rule, with the grouping, filters and selection the issue was raised from. See Raise issues from failures.Issues and model versions
An issue stores the models that were in the scene when you raised it, including a specific version if you were viewing one. Opening the issue from Issues loads those models. If you raised it on an earlier version, that version loads, so you see the model as it was when the problem was found. If the version cannot load, the viewer shows Couldn’t load the version this issue was created on.What if the object an issue references was deleted in later versions?
What if the object an issue references was deleted in later versions?
Should I resolve issues when I publish a new version with fixes?
Should I resolve issues when I publish a new version with fixes?
Notifications
You receive email notifications when:- An issue is assigned to you
- Someone replies to an issue you created, are assigned to, or have replied to
Permissions
Issue permissions depend on your project role and whether you created or are assigned to a specific issue.Important notes
- Nobody can edit replies after posting, including project owners.
- You must be signed in and have a project role to create issues or reply, even on a public project.
- An assignee can change every field except the assignee.
If an issue action is blocked
Check these conditions:- Cannot create an issue or reply -> confirm you are signed in and have the Reviewer project role or higher.
- Cannot change a field -> only the issue’s creator, its assignee, or a project owner can.
- Cannot set priority, assignee, due date, or labels -> the project must belong to a workspace.
- Cannot see an expected issue -> check filters and include Resolved if needed.
- Cannot assign a user -> confirm the user has access to that project.
Why can't I edit someone else's issue?
Why can't I edit someone else's issue?
Can I remove myself as an assignee?
Can I remove myself as an assignee?
Why can't I edit my own reply?
Why can't I edit my own reply?