Introduction

Get to know about Roled, why it exists, and how it can help you manage users, roles, and permissions across all your projects.

What is Roled?

Roled is a developer platform designed to instantly power your applications with complete user, role, and permission management capabilities.

Instead of starting from zero and spending weeks engineering user databases, authentication flows (sign up, sign in, password reset), role hierarchies, and granular access controls for every single project, Roled delivers all of it out of the box. Connect your applications to Roled as a centralized shared service and manage everything seamlessly from one place.

Why Roled?

Every new application eventually requires a way to handle users and control who can access what. Historically, developers have had to spend weeks — or even months — reinventing the wheel: writing user schemas, building sign-up and sign-in interfaces, crafting custom role logic, and designing bespoke admin panels for every repository.

Roled eliminates that repetitive burden forever.

By integrating Roled, your application instantly gains:

• Complete User Onboarding & Auth: Ready-to-use sign up, sign in, password reset, and user management features.
• Granular Role & Permission Control: Flexibly define roles, assign fine-grained permissions, and restrict resource access across your app.
• Multi-Project Centralization: Manage users, roles, and access rights across all your apps from a single, unified console.

Treat Roled like a plug-and-play internal service — simple REST API calls, predictable flows, zero auth headache.

Key Features

Roled comes with the following key features to help you build amazing applications. In addition, you can use it along with your existing authentication system for enhanced flexibility and control.

• Centralized Management: Manage users, roles, and permissions across all your projects from a single console — no more scattered admin panels.
• Multi-Project Support: Create isolated projects for each application, each with its own users, roles, and access rules.
• API-First Design: Every action available in the console is also available through a clean and simple REST API.
• Built-in Authentication: Need a login flow? Roled provides an OAuth2 auth page out of the box — no extra setup required.
• Bring Your Own Users: Already have a user system? Integrate with Roled using external user IDs and let Roled handle the roles.
• Complete Out of the Box: User registration, role assignment, password reset, email verification — all included and ready to use.

Two Ways to Manage Users

Roled supports two distinct approaches to managing users, allowing you to choose the model that best aligns with your project’s architecture and requirements.

Fully Managed Users

Ideal for rapid project initialization, this option centralizes user data management within Roled. Authentication is streamlined through the dedicated Roled Auth page, eliminating the need to build authentication flows from scratch.

This approach is particularly beneficial for teams aiming for quick time-to-market. Once authenticated, users are seamlessly redirected to your application.

Best for: New projects that want a complete user management system without building anything from scratch.

Decoupled Users (Bring Your Own Users)

For projects requiring greater flexibility and control over user data, Roled offers a decoupled model. In this scenario, user management and authentication are handled entirely by your own system. Your application integrates with Roled solely to retrieve user data and role information.

Best for: Projects that already have their own user management systems with strict data privacy and security requirements, but also want a simple way to manage roles and permissions.

How It Works

1. Create an account on the Roled Console.
2. Create a project for each of your applications.
3. Define roles and resources that match your application’s access model.
4. Register users — either through Roled’s managed auth flow or using external user IDs.
5. Use the Roled API to get the user’s roles and permissions or create your own user management system.
6. Enforce access controls in your application based on the user’s roles and permissions.