Module Access Denied: Understanding Permissions

Learn how module permissions work in Piraja CRM. Understand the difference between Business Admin and User level access, plan limitations, and how to resolve permission errors.

Published 11/16/2025•Updated 11/16/2025•8 min read

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

Plan Limitations

Understanding Plan Tiers

Different plans include different modules:

Free Plan

  • Core CRM modules only
  • Basic features
  • Limited integrations
  • Community support

Pro Plan

  • All core modules
  • Advanced features
  • More integrations
  • Priority support

Enterprise Plan

  • All modules
  • All features
  • All integrations
  • Dedicated support

Module Availability by Plan

Some modules require specific plan tiers:

Free Plan Modules:

  • Individuals
  • Organizations
  • Notes
  • Tasks
  • Basic Tickets

Pro Plan Modules:

  • All Free plan modules, plus:
  • Advanced Opportunities
  • Pipeline
  • Calendar integrations
  • Advanced Billables

Enterprise Plan Modules:

  • All modules
  • Custom integrations
  • Advanced Aiden features
  • Performance analytics

Checking Your Plan

  1. Go to Business Settings → Plan (Business Admins only)
  2. Or contact your business administrator
  3. Check which modules are available on your current plan

Upgrading Your Plan

If you need a module that's not on your plan:

  1. Contact your business administrator
  2. They can upgrade the business plan
  3. Once upgraded, the module will be available
  4. Business admin can then enable it for your business

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 on your plan
  • Solution: Contact business admin or check plan

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

  • Meaning: Same as above, more explicit
  • Cause: Business admin disabled it, or plan limitation
  • Solution: Verify with business admin

"This module is not available on your plan"

  • Meaning: Your plan doesn't include this module
  • Cause: Plan tier too low
  • Solution: Upgrade plan (business admin must do this)

"Module locked by plan"

  • Meaning: Module requires higher plan tier
  • Cause: Current plan doesn't support this module
  • Solution: Upgrade plan

"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
  • Your plan tier
  • Steps you've already tried
  • Screenshots of error messages

2. Contact Support

  • Email: support@piraja.com (or your support email)
  • 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

Additional Resources

  • Module System Guide: Complete guide to modules
  • Plan Information: Details about plan tiers
  • Settings Help: How to navigate settings
Was this helpful?