Module Access Denied: Understanding Permissions

This guide explains how module permissions work in Piraja CRM. Learn about the two-level access system (Business Admin and User), plan limitations, and how to resolve common permission errors.

Problem Statement

The Issue

You're trying to access a module but getting an error message like:

• "Module access denied"
• "You don't have permission to access this module"
• "This module is not available on your plan"
• "Module locked by plan"
• Getting a 404 error when accessing a module URL

Common Scenarios

Scenario 1: Permission Error

• You see the module in navigation but can't access it
• Clicking the module gives an error
• Module appears grayed out or disabled

Scenario 2: Plan Limitation

• Error message mentions your plan
• Module is listed but says "Upgrade required"
• You can see the module but can't use its features

Scenario 3: Business Admin Restriction

• Module is disabled at business level
• You can't enable it in your personal settings
• Error says "Disabled by business administrator"

Understanding the Two-Level Access System

Business Admin vs User Level

Piraja CRM uses a two-level access system:

Business Administrator Level

• Controls which modules your entire business can access
• Can enable/disable modules for all users
• Has full control over business-wide module settings
• Can override individual user preferences

User Level

• Controls which modules appear in your personal navigation
• Can show/hide modules you have access to
• Cannot enable modules disabled by business admin
• Personal preferences only

How It Works

For you to access a module:

1. Business Admin must enable it for your business
2. You must enable it in your personal settings (optional, but recommended)

If either level blocks access, you won't be able to use the module.

The Hierarchy

Business Enabled → User Enabled = Full Access Business Enabled → User Disabled = Hidden but Available Business Disabled → User Enabled = Not Accessible

Module Availability

How Module Access Works

Available modules depend on your subscription. Your business administrator can enable or disable modules for your organization.

If you need a module that is not available:

1. Contact your business administrator to see if it can be enabled for your business
2. If the module is not available for your subscription, contact support at support@piraja.io
3. Ensure any required dependencies are enabled (e.g. Organizations for BRREG)

Permission Error Messages Explained

Common Error Messages

"Module access denied"

• Meaning: You don't have permission to access this module
• Cause: Module disabled at business level, or not available for your subscription
• Solution: Contact business admin or support@piraja.io

"You don't have permission to access this module"

• Meaning: Same as above, more explicit
• Cause: Business admin disabled it, or module not available for your subscription
• Solution: Verify with business admin

"This module is not available"

• Meaning: This module is not included for your organization
• Cause: Subscription or business-level settings
• Solution: Contact your business administrator or support@piraja.io

"Module locked"

• Meaning: Module is not available for your organization
• Cause: Subscription or business-level settings
• Solution: Contact your business administrator

"Disabled by business administrator"

• Meaning: Business admin has disabled this module
• Cause: Business-level setting
• Solution: Ask business admin to enable it

404 Error (Page Not Found)

• Meaning: Module doesn't exist or you don't have access
• Cause: Module disabled, wrong URL, or access denied
• Solution: Check module is enabled, verify URL

Step-by-Step Solutions

Solution 1: Check Your Personal Module Settings

For any user:

1. Go to Settings → Modules (or /modules)
2. Find the module you want to access
3. Check if it's toggled ON
4. If OFF, toggle it ON
5. Refresh the page

Note: If you see "Disabled by business admin", you need Solution 2.

Solution 2: Ask Business Admin to Enable Module

If you're not a business administrator:

1. Contact your business administrator
2. Explain which module you need access to
3. Ask them to:
   • Go to Business Settings → Modules
   • Find the module
   • Enable it for your business
4. Once enabled, you can enable it in your personal settings

If you're a business administrator:

1. Go to Business Settings → Modules
2. Find the module
3. Check if it's available on your plan
4. If available, toggle it ON
5. All users can now access it (if they enable it personally)

Solution 3: Upgrade Your Plan

If module requires a higher plan:

1. Business Admin should:
   • Go to Business Settings → Plan
   • Review available plans
   • Upgrade to the plan that includes the module
2. After upgrade:
   • Module becomes available
   • Business admin can enable it
   • Users can then access it

Note: Only business administrators can upgrade plans.

Solution 4: Verify Module Dependencies

If module requires another module:

1. Check which module is required
2. Ensure the required module is enabled at business level
3. Enable the required module in your personal settings
4. Then enable the dependent module

Example:

• Google Calendar requires Calendar module
• Enable Calendar first, then Google Calendar

Solution 5: Check Your User Role

If you're getting permission errors:

1. Verify your user role:
   • Go to Profile → Account
   • Check your role (User, Business Admin, etc.)
2. Some features may require specific roles
3. Contact business admin if you need role changes

Solution 6: Clear Cache and Refresh

If settings seem correct but still getting errors:

1. Clear browser cache
2. Hard refresh:
   • Windows/Linux: Ctrl + Shift + R
   • Mac: Cmd + Shift + R
3. Log out and log back in
4. Try accessing module again

Common Causes

Why Permission Errors Happen

1. Module Disabled at Business Level

• Business administrator disabled the module
• Solution: Ask business admin to enable it

2. Plan Limitations

• Your plan doesn't include the module
• Solution: Upgrade plan (business admin must do this)

3. Module Hidden in Personal Settings

• You toggled the module OFF
• Solution: Toggle it back ON in Settings → Modules

4. Missing Dependencies

• Required module is not enabled
• Solution: Enable required module first

5. Incorrect User Role

• Your role doesn't have access
• Solution: Contact business admin to change role

6. Browser Cache Issues

• Old cached data showing incorrect permissions
• Solution: Clear cache and refresh

7. Module Not Released

• Module is still in development
• Solution: Wait for release or contact support

8. Business Context Issues

• Logged into wrong business
• Solution: Verify you're in the correct business account

Prevention Tips

How to Avoid Permission Issues

1. Understand Your Plan

• Know which modules are included in your plan
• Check plan limitations before expecting access
• Understand upgrade requirements

2. Communicate with Business Admin

• Ask about module availability
• Request access when needed
• Understand business module strategy

3. Regular Access Reviews

• Periodically review your module access
• Check if you need additional modules
• Verify all needed modules are enabled

4. Document Module Requirements

• Keep track of which modules your role needs
• Note any dependencies
• Document plan requirements

5. Test After Changes

• After enabling modules, verify access works
• Test on multiple browsers if possible
• Clear cache if changes don't take effect

Still Not Working?

When to Contact Support

If you've tried all solutions and still can't access the module:

1. Gather Information Before contacting support:

• Module name
• Exact error message
• Your user role
• Steps you've already tried
• Screenshots of error messages

2. Contact Support

• Email: support@piraja.io
• In-App: Use the help icon (?) in the interface
• Knowledge Base: Search for related articles

3. What Support Will Need

• Your account email
• Business name
• Module name
• Error message
• Steps you've tried
• Screenshots (if possible)

Related Articles

• Why Can't I See a Module in My Navigation?
• Understanding the Module System

Additional Resources

• Module System Guide: Complete guide to modules
• Settings Help: How to navigate settings