Issues

Issues in Speckle let you report problems, request changes, and manage feedback tied directly to specific objects in your models. Create issues by clicking on geometry, assign them to teammates, set priorities and due dates, and track progress from creation to completion.

​

Creating issues

1. Open a model in the 3D viewer
2. Click on any object in the model to select it
3. The issue creation window appears floating over the viewer
4. Add a title and description for your issue
5. Optionally set status, assignee, due date, priority, or labels
6. Click Create to save the issue

The issue window can be repositioned by clicking and dragging its title bar anywhere on the screen.

​

Issue properties

Each issue has multiple fields to help you organize and prioritize work.

​

Title and description

Give your issue a clear title and add details in the description. The description supports formatting via keyboard shortcuts (cmd/ctrl+B for bold, cmd/ctrl+I for italics) and can include as much context as needed.

​

Status

Track progress with three status options:

• Open - Issue needs attention (default)
• Ready for Review - Work is complete and needs verification
• Done - Issue is resolved

​

Assignee

Assign issues to any user in your workspace. For private projects, you can only assign users who have been explicitly added to the project as collaborators. Assigned users receive an email notification.

​

Due date

Set a deadline for when the issue should be resolved. Overdue issues can be filtered and highlighted in issue lists.

​

Priority

Indicate urgency with four priority levels: No priority (default), Low, Medium, High.

​

Labels

Tag issues with one or multiple labels. Labels help categorize issues by discipline, phase, issue type, or any other criteria relevant to your project. Your workspace comes with a set of default labels, but workspace admins can create custom labels from Workspace settings > Issue labels. Each label has a name and color, and labels are available across all projects in your workspace.

​

Collaboration

​

Replies

Add comments to any issue to discuss the problem, propose solutions, or provide updates. Replies appear chronologically below the issue description. Anyone with the Can view project role or higher can reply to issues. Anyone who created an issue, is assigned to it, or has previously commented will receive email notifications when new replies are added.

​

Mentions

Mention specific users in issue descriptions or replies by typing @ followed by their name. Mentioned users receive an email notification directing them to the issue. In private projects, you can only mention users who have access to the project.

​

Attachments

Attach images, files and markups to issues or replies to provide additional context:

• Click Attach image or file to upload from your device
• Drag and drop files directly into the issue window
• Click Attach markup to create an annotated screenshot using Speckle’s markup tools

Attachments help clarify problems visually and provide reference materials for resolution.

​

Issue activity

Below the replies, the issue activity log shows all changes made to the issue over time. See when someone changed the status, adjusted the priority, added labels, or modified the due date. This provides a complete audit trail of the issue’s lifecycle.

​

Managing issues

​

Issues panel in the viewer

Access all issues for the currently loaded models from the Issues panel in the viewer. The panel shows issue titles, status, priority, labels, and assignees at a glance. By default, issues marked as Done are hidden to keep the list focused on active work. Filter issues by:

• Status
• Assignee
• Due date
• Priority
• Labels
• Overdue status
• Current version only (show only issues created on the loaded model version)

Click any issue in the list to open it and see the associated objects highlighted in the model.

​

Issues tab in the project

From the project’s Issues tab, view all issues across all models in the project. This gives you a project-wide view of outstanding work. Filter the list by status, assignee, due date, priority, labels, or use the search box to find issues by text.

​

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.

​

Issues in Speckle Intelligence

Issues integrate with Speckle Intelligence dashboards, allowing you to create custom visualizations and reports. Add Issues widgets to your dashboards to:

• List all issues for loaded models
• Filter by label, assignee, or other properties
• Track issue counts over time by model version
• Visualize issue distribution across your project

This is useful for project managers tracking team progress or identifying bottlenecks in the review process.

​

Version tracking

Issues are tied to the model version they were created on. This ensures you can always see the exact state of the model when the problem was identified. When you open an issue, it displays the latest model version by default. To see the original context:

1. Open the issue
2. Click the ··· menu on the issue in the Issues panel
3. Select Load with original version

The viewer will load the model version that existed when the issue was created. You can also filter the Issues panel to show only issues created on the currently loaded version using the “Is from current version” filter.

​

Notifications

You receive email notifications when:

• An issue is assigned to you
• Someone mentions you in an issue or reply
• Someone replies to an issue you created, are assigned to, or have previously commented on

​

Permissions

Issue permissions depend on your project role and whether you created or are assigned to a specific issue. Important notes:

• Nobody can edit issue comments after posting, including project owners
• You must have a Speckle account to create issues or comment, even in public projects
• Anyone in the workspace can be assigned to an issue, regardless of their project role
• Being assigned to an issue grants you edit permissions for that issue’s title, description, and properties
• Configure external user permissions from Project settings > Visibility

​

Availability

The Issues feature is fully available without limits in all Speckle plans, including Free. For self-hosted Speckle servers, the core Issues functionality is available including issue title, description, status tracking, attachments, and replies. Additional features like labels, priority, assignee, due dates, and markup attachments are only available in hosted Speckle workspaces as they depend on workspace-level infrastructure.