# applyDecorators

**Kind:** Function

**Source:** [`packages/common/decorators/core/apply-decorators.ts`](https://github.com/nestjs/nest/blob/master/packages/common/decorators/core/apply-decorators.ts#L10)

**Part of:** [Common](subsystem-packages-common)

Function that returns a new decorator that applies all decorators provided by param

Useful to build new decorators (or a decorator factory) encapsulating multiple decorators related with the same feature

`applyDecorators` combines multiple class, method, or property decorators into a single reusable decorator. It applies each supplied decorator in order, making it useful for creating feature-specific decorator factories that encapsulate related metadata, guards, interceptors, or other decorator behavior.

## Signature

```ts
function applyDecorators(decorators: Array<ClassDecorator | MethodDecorator | PropertyDecorator>)
```

## Parameters

| Name | Type |
|---|---|
| `decorators` | `Array<ClassDecorator | MethodDecorator | PropertyDecorator>` |

## Diagram

```mermaid
graph LR
  A[Custom decorator factory] --> B[applyDecorators]
  B --> C[Decorator 1]
  B --> D[Decorator 2]
  B --> E[Decorator N]
  C --> F[Target class, method, or property]
  D --> F
  E --> F
```

## Usage

```ts
import {
  applyDecorators,
  SetMetadata,
  UseGuards,
} from '@nestjs/common';

const RolesGuard = class {};

export function AdminOnly() {
  return applyDecorators(
    SetMetadata('roles', ['admin']),
    UseGuards(RolesGuard),
  );
}

class UsersController {
  @AdminOnly()
  removeUser() {
    return 'User removed';
  }
}
```

## AI Coding Instructions

- Use `applyDecorators` when multiple decorators represent one cohesive feature or policy, such as authorization, caching, or API behavior.
- Preserve decorator ordering, since decorators are applied in the order they are passed to `applyDecorators`.
- Ensure every provided decorator is valid for the intended target type: class, method, or property.
- Prefer creating named decorator factories, such as `AdminOnly()` or `PublicEndpoint()`, instead of repeating the same decorator combination across controllers.