---
title: "onShaderRegistered"
description: "Be told when a user-defined shader is registered, replaced or removed."
group: "define"
groupTitle: "Defining a shader"
categoryId: "define"
categorySlug: "define"
categoryTitle: "defineShader & wgsl"
kind: "function"
sourceUrl: "https://github.com/shader-effects-inc/shaders/blob/main/packages/core/src/customShaders.ts#L109"
---

# onShaderRegistered

Be told when a user-defined shader is registered, replaced or removed.

```ts
onShaderRegistered(listener: (name: string, definition: GpuShaderDefinition | null) => void): () => void
```

Import `onShaderRegistered` from `shaders/std`.

The listener gets the name and the new definition, or `null` on removal. Returns a function that unsubscribes. Useful for a component picker or a live editor that lists custom shaders.

## Parameters

| Name | Type | Notes |
|---|---|---|
| `listener` | `(name: string, definition: GpuShaderDefinition \| null) => void` |  |

## Example

```ts
const stop = onShaderRegistered((name, definition) => refreshPicker())
```

## See also

- [`registerShader`](/docs/primitives/define/registershader) — Make a user-defined shader findable by its `name`, so preset JSON can reference it as `type: 'Halo'`.
- [`getRegisteredShaders`](/docs/primitives/define/getregisteredshaders) — Every user-defined shader currently registered, oldest first.