> ## Documentation Index
> Fetch the complete documentation index at: https://confidence.spotify.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a Custom Role

> Learn how to create custom roles from fine-grained permissions.

export const HowToSchema = ({name, description, steps = []}) => {
  const schema = {
    "@context": "https://schema.org",
    "@type": "HowTo",
    name,
    description
  };
  if (steps.length > 0) {
    schema.step = steps.map((s, i) => ({
      "@type": "HowToStep",
      position: i + 1,
      name: typeof s === "string" ? s : s.name,
      text: typeof s === "string" ? s : s.text || s.name
    }));
  }
  return <script type="application/ld+json" dangerouslySetInnerHTML={{
    __html: JSON.stringify(schema)
  }} />;
};

<HowToSchema
  name="Create a Custom Role"
  description="Learn how to create custom roles from fine-grained permissions."
  steps={[
{ name: "Go to Roles", text: "Go to Admin > Roles." },
{ name: "Click Create", text: "Click Create to create a custom role." },
{
  name: "Configure the role",
  text: "Give the role a name, and add the relevant permissions. For each permission you can select one or several types: - Reader - Can view the type of resource that the permission handles - Creator - Can create the type of resource that the permission handles - Editor - Can edit (which includes reading and creating) the type of resource that the permission handles - Admin - Has all permissions for this type of resource",
},
{
  name: "Save the role",
  text: "You can add as many permissions and permission types as you need to one role.",
},
]}
/>

Create [custom roles](../iam/roles#custom-roles) from fine-grained permissions to fit your organization's needs.

## Create a Custom Role

<Steps>
  <Step title="Go to Roles">
    Go to **Admin > Roles**.
  </Step>

  <Step title="Click Create">
    Click **Create** to create a custom role.
  </Step>

  <Step title="Configure the role">
    Give the role a name, and add the relevant permissions. For each permission you can select one or several types:

    * **Reader** - Can view the type of resource that the permission handles
    * **Creator** - Can create the type of resource that the permission handles
    * **Editor** - Can edit (which includes reading and creating) the type of resource that the permission handles
    * **Admin** - Has all permissions for this type of resource
  </Step>

  <Step title="Save the role">
    You can add as many permissions and permission types as you need to one role.
  </Step>
</Steps>

<Note>
  Only the creator and reader permission types are meaningful to combine for the same type of resource. For all other combinations, one type of permission includes the other.
</Note>

<Note>
  To give the custom role to a user or group, create a [policy](../iam/policies).
</Note>

## Related Resources

<CardGroup cols={2}>
  <Card title="Roles Reference" href="/docs/iam/roles">
    Deep dive into role configuration
  </Card>

  <Card title="Create Policies" href="/docs/how-to-guides/create-policy">
    Assign roles to users and groups
  </Card>

  <Card title="Invite Users" href="/docs/how-to-guides/invite-user">
    Add new users to your organization
  </Card>
</CardGroup>