Understanding the Structure — Workspace, Projects & Versions
Written By Team BugSmash
Last updated 4 days ago
Why it’s useful
Understanding how BugSmash organises feedback helps to keep your workflow clean, structured, and easy to manage as the projects grow.
The hierarchy avoids confusion by properly separating clients, projects, and feedback.
How it works (Hierarchy)
1) Workspace (Top level)
A Workspace is the main umbrella for your organisation.
It contains:
Members
Collaborators / Guests
Folders
Projects
Workspace-level settings
Add-ons
Billing and plans
2) Folders
Folders help to organise projects in a structured way.
Each folder can contain:
Multiple projects
Multiple subfolders (folders within folders)
You can use folders to separate clients.
Example:
Client A → Folder A
Client B → Folder B
3) Projects
A Project is a dedicated feedback space for a specific deliverable.
All comments, reviews, and versions are attached here.
Projects can be created for:
Websites (Supports AI Review)
HTML (Supports AI Review)
Widgets
PDFs (Supports AI Review)
Videos
Images (Supports AI Review)
Audio
Emails
PPTs (Supports AI Review)
Docs (Supports AI Review)
Mobile Apps
3D Models
CAD
4) Versions
Versions help to manage different stages/updates of the same project in one place.
Each time you upload an updated file/design, a new version is created, for eg, (v1, v2, v3...)
5) Comments
Comments are where all feedback and annotations get added inside a project.
Each comment remains linked to the specific version where it was originally added, making it easy to track feedback across different versions.
6) Replies
Replies help teams to continue discussions inside the same comment thread.
Instead of creating separate comments, users can reply directly to an existing comment to discuss updates, fixes, or clarifications.
Each reply stays connected to its comment, keeping the feedback workflow clean and organised.
(Note: You can also add private replies, which are only visible to the internal team, which includes owners, admins, and members.)
Tips
- Separate client deliverables into projects or folders. You can also have 1 folder per client.
- Move old projects into archived files instead of deleting — keeps version history intact.
Was this helpful?
More in Getting Started
Creating Your First ProjectRenaming projects and filesProject VersioningCompare Project VersionsStill need help? Ask the team