Troubleshooting / FAQs
Frequently Asked Questions (FAQ)
This section answers common questions for Colabmacs users — people booking resources, completing training, and working within projects.
If something isn’t working as expected, your facility staff or project owner is always the best first point of contact.
Getting Started
What is Colabmacs?
Colabmacs is a platform used by facilities to manage shared resources, training, bookings, and usage tracking.
As a user, Colabmacs helps you:
- Find available resources
- Complete required training
- Book equipment or spaces
- Start and track usage sessions
- Review usage records and charges
- Communicate with facility staff
Do I need to install anything?
No. Colabmacs runs entirely in your web browser.
You only need:
- A modern browser (Chrome, Firefox, Safari, or Edge)
- An internet connection
Best experience:
Desktop or laptop devices are recommended. Some workflows are not optimized for small screens.
How do I get access?
Access is provided by your facility or organization.
This usually happens when:
- You are added to a team or project
- Your account is migrated from a legacy system
- You register using a facility-approved email address
If you’re unsure how to get access, contact your facility administrator.
I just registered — what happens next?
After registration, most users will be guided through an onboarding flow.
This may include:
- Accepting terms and conditions
- Joining an existing team
- Creating a new team
- Creating your first project
What happens next depends on how your facility is configured and whether you are joining an existing organization or setting up a new one.
If you are unsure what to do after registering, review the Onboarding guide or contact facility staff.
Account & Login
I can’t log in — what should I check first?
Try the following:
- Confirm you’re using the correct email address
- Check for spelling errors
- Reset your password if needed
- Refresh the page or try another browser
If you previously used a legacy system, your email may need to be updated or verified to link your existing records.
I used a different email in the past — what happens to my history?
If your facility migrated from a legacy system, your:
- Training records
- Usage history
- Access permissions
may be tied to your original email address.
In this case:
- Do not create a new account
- Follow the Update Email process instead
This ensures your existing records remain intact.
Can I change my email address?
Yes — but some facilities require a verification step to preserve your history.
If you’re unsure, check the Update Email guide or contact your facility administrator.
The page looks strange or I keep getting logged out — what should I try?
Try the following:
- Refresh the page
- Sign out and sign back in
- Try another supported browser
- Disable aggressive browser extensions if they interfere with logins or popups
- Clear cached site data if the issue persists
These steps often resolve:
- Stale page content
- Missing updates after a change
- Session timeouts
- Browser-specific display problems
If the issue continues, contact your facility administrator and let them know which browser and page you were using.
Notifications & Email
Why am I not getting email notifications?
The most common causes are:
- Email notifications are disabled in your preferences
- All notification channels are disabled
- The relevant notification category is disabled
- You are not subscribed to the specific item
- The message was filtered into spam, junk, or another mailbox tab
Check your Notification Preferences first.
Why did I get an in-app notification but not an email?
Notification channels are managed separately.
For example:
- In-App ON
- Email OFF
means you will still receive notifications inside Colabmacs, but not by email.
Are some notifications always sent?
Yes, some facility-level communications may still be delivered even when other notification preferences are limited.
This is typically used for important facility-wide communication.
Can I subscribe to my bookings in Google Calendar, Outlook, or Apple Calendar?
Yes.
Colabmacs can generate a private calendar subscription URL for your personal bookings.
You can use this with:
- Google Calendar
- Outlook
- Apple Calendar
See Schedule & Calendar for the subscription workflow.
Projects
What is a project?
A project is how Colabmacs groups your work.
All of the following belong to a project:
- Bookings
- Usage sessions
- Usage records
- Charges (if applicable)
Before booking or starting a session, always confirm you are working in the correct project.
How do I switch projects?
Use the Project Switcher in the main navigation:
- Click the project name at the top of the menu
- Select another available project
- The selected project becomes active immediately
New bookings and sessions will use this project by default.
What happens if a project is suspended or expired?
When a project is suspended or expired:
- Existing records remain visible
- Usage and charge history is preserved
- New bookings or sessions may be blocked
If you still need access, contact the project owner or facility staff.
Why can’t I see the project I expected?
Common reasons include:
- You are not a member of that project
- The project belongs to a team you are not involved with
- The project is inactive, suspended, or expired
- Your facility intentionally limits which projects are visible to you
If you recently joined a team, remember that team membership does not always automatically add you to a project.
If you believe a project is missing, contact the project owner, team manager, or facility staff.
Why can’t I see a team I expected?
This is often caused by one of the following:
- You were not added to the team
- Your join request is still pending
- You were added directly to a project without being added to the team itself
- The team is not public or otherwise visible to you
If you are unsure, ask facility staff or the team owner to confirm whether you should be on the team, the project, or both.
Resources & Bookings
Why can’t I book a resource?
Common reasons include:
- Required training is missing or expired
- The resource is unavailable or under maintenance
- The booking violates facility rules
- The project is inactive or expired
Colabmacs will usually indicate what’s missing and how to proceed.
For more detail, see Resources and Managing Bookings.
What’s the difference between a booking and a session?
- Booking – A reservation for future time
- Usage Session – Created when you start using the resource
- Usage Record – The recorded result of a session
- Charge – Generated from a usage record if rates apply
A usage session typically starts once your booking becomes active.
Why can’t I start a session?
Common reasons include:
- Your booking is not active yet
- Required training is missing, expired, or revoked
- The project is suspended, expired, or otherwise inactive
- The resource is unavailable, under maintenance, or blocked by schedule rules
- A facility access rule prevents activation
- The booking has already become Late or Missed
If the system allows session starts, it will usually show a Begin Session button when the booking becomes active. If that button does not appear, review the booking, resource requirements, and current project first.
Why does a resource show as unavailable?
A resource may be unavailable because of:
- Planned downtime or maintenance
- Business hours or schedule restrictions
- Holiday closures
- Active bookings by other users
- Facility access rules that block the current time or user
This does not necessarily mean something is broken. In many cases, the facility has intentionally blocked the resource for safety, fairness, or operational reasons.
See Resources for more on availability, schedules, training, and access requirements.
Why does my booking show “Late” or “Missed”?
Facilities often define a grace period.
- Late – The session was not started within the grace period
- Missed – The booking ended without a session being started
These states help facilities manage availability and fairness.
Training & Access
Why do I need training?
Training ensures:
- Safe operation of equipment
- Compliance with facility policies
- Appropriate access to restricted resources
Training requirements vary by resource, location, or process.
How do I get trained?
You can:
- Join a scheduled training session
- Request individual training
- Request training directly from a resource page
If a session is full, a waitlist may be available.
What happens if a training session is full?
If the facility supports it, you may be able to join a waitlist.
Depending on facility configuration:
- You may be notified if a space opens
- Staff may contact you with another option
- You may need to choose another session or submit a request
If no waitlist is available, contact facility staff or submit a training-related request.
What do my training statuses mean?
Your training records typically use statuses such as:
- Valid – Training is complete and access is allowed
- Expired – Training is no longer valid and must be renewed
- Revoked – Training was removed or invalidated
If a required training is Expired or Revoked, booking or session start may be blocked until retraining is completed.
You can review your current status in Training & Access.
What happens when training expires?
Expired or revoked training:
- Prevents booking or starting sessions
- Can usually be renewed by requesting retraining
Once training is revalidated, access is restored automatically.
Requests & Communication
What are requests used for?
Requests are how you communicate with the facility, including:
- Training requests
- Configuration requests
- Issue reports
- Special access requests
Requests create a shared conversation between you and facility staff.
Can I update a request after submitting it?
Yes. Users can typically:
- Edit certain request details
- Add additional information
- Attach files
- Communicate using threaded comments
All communication stays tied to the request for clarity.
Why haven’t I received a response to my request yet?
Request timing varies by facility, request type, and staff workload.
Keep in mind:
- Some requests require manual review or approval
- Some requests involve multiple staff members
- Replies may appear in the request thread rather than as a direct email
- Notifications depend on your notification preferences
The best place to check status is the request itself. If a request has been sitting for longer than expected, add a polite follow-up comment or contact facility staff.
Where do request updates appear?
Request updates usually appear in:
- The request’s threaded comments
- The request’s activity history
- Your Dashboard
- Your notifications, if enabled
This is why checking the request detail page is usually more reliable than relying only on email.
Why did my request attachment upload fail?
One common reason is that the file type is not allowed by the facility configuration.
In that case, you may see an error such as 422.
Try the following:
- Confirm the file type is supported
- Compress the file into a
.ziparchive if appropriate - Contact facility staff if you need a file type that is currently blocked
Usage Records & Charges
What are usage records?
Usage records are the finalized system record of your usage.
They show:
- What was used
- Which project it belonged to
- What quantity or duration was recorded
- Whether a charge was generated
They provide transparency and traceability for your work.
What’s the difference between a usage session and a usage record?
This is an important distinction:
- Usage Session – The live activity while you are actually using the resource
- Usage Record – The finalized record Colabmacs stores after the session is complete
In practice, this means:
- A session reflects the real check-in to check-out interaction
- A usage record is the persistent record used for reporting and billing
- A single session may create more than one usage record
- The final usage record may reflect facility rules, system modeling, or billable breakdowns rather than just a simple copy of the live session
Examples:
- One resource session may also create separate records for a process or configuration
- A facility may track billable quantities in a specific unit or split usage into separate records for reporting
If you are comparing what you did in real time to what appears later in reporting or billing, the usage record is the authoritative record to review.
Will I always be charged for usage?
Not necessarily.
Charges depend on:
- Facility policies
- Resource rates
- Project configuration
- The finalized usage record created from the session
Some usage is tracked for reporting even if no charge is generated.
Why did my charge change or look different than I expected?
Charges are usually based on actual usage, not only booked time.
Differences can happen because of:
- Actual usage duration differing from the booking duration
- The finalized usage record differing from the live session representation
- Resource-specific or project-specific billing rules
- Process or configuration choices affecting billing
- Facility adjustments or charge regeneration after a correction
If something looks incorrect, contact facility staff and provide the relevant booking, usage record, or project details.
Who should I contact about a billing discrepancy?
Start with:
- Facility staff
- The project owner or team owner
- Your facility administrator, if they manage billing workflows
They can review the underlying usage, project, and billing configuration with you.
Can I export my usage history?
Yes. Usage records can usually be filtered and exported (for example, as CSV files) for:
- Reporting
- Reimbursement
- Personal records
See Usage Records for more detail.
Getting Help
Something doesn’t look right — what should I do?
If you notice:
- Incorrect usage
- Missing training
- Unexpected restrictions
Use Requests or contact your facility administrator.
They have visibility into training, rules, and configuration.
Who should I contact for help?
Colabmacs is configured per facility.
If you need help with access, permissions, missing features, or unexpected restrictions, contact your facility administrator, facility staff, or project owner, depending on how your facility is organized.
Permissions & Missing Features
I see “Unauthorized action” or “You can’t do that” — what does it mean?
In most cases, this means your account does not currently have the required permission for that action.
This can happen when:
- Your assigned role does not include the needed permission
- A facility-specific role was changed
- You are missing access that another staff member expected you to have
If this happens, contact your facility administrator or facility staff and let them know what page or action you were trying to use.
A button, dropdown, tab, or page is missing — is that also a permissions issue?
Usually, yes.
Many parts of the Colabmacs interface are permission-aware. If you do not have permission to view or use something, the system may hide it entirely instead of showing it in a disabled state.
Common examples:
- A page does not appear in navigation
- A button or action is missing from a detail screen
- A dropdown does not include an expected option
- An admin page is visible to one user but not another
This is usually expected behavior and most often points to a missing permission.
What should facility administrators check?
Facility administrators should review the user's roles and the permissions attached to those roles.
Start with the Authorization page and check:
- The roles assigned to the user
- The permissions included in those roles
- Whether the expected
view_*,create_*,update_*, ormanage_*permissions are present
If the user should have access but still does not, compare their assigned roles to another user who can see or perform the same action.
Admin Troubleshooting Pattern
If something is missing from the UI, first check for a missing view_* permission. If the page is visible but the user cannot perform an action, check for the corresponding create_*, update_*, delete_*, or manage_* permission.
For most questions, contact:
- Facility staff
- Project owners
- Lab or shop administrators
They can resolve issues much faster than general support.
Final Tip
Colabmacs is designed to guide you, not block you.
If you can’t do something, there is usually:
- A missing training
- A project issue
- A rule you need to be aware of
The system will point you in the right direction — and your facility team is always there to help.