---
url: /en/repo/settings-reaction.md
description: >-
  Explains how to replace default reaction icons with custom images (such as a
  project mascot) via .cnb/settings.yml to match the repository's visual style.
---
Replace the default image in the reaction feature with a custom image that matches your repository's style.

## Use Cases

* Replace the default reaction icon with a project mascot or logo
* Make repository interactions more distinctive and recognizable
* Match the visual style of your project theme

## Configuration

Add the `reaction` configuration to `.cnb/settings.yml`:

```yaml title=".cnb/settings.yml"
# Reaction custom image
reaction:
  # Define the replacement image for the "bug" position of the reaction feature
  # Only use images from the repository's default branch,
  # provide a relative path from the repository root, e.g., .cnb/bug.gif
  bug:
    image: .cnb/bug.gif
```

## Parameter Reference

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `reaction.bug.image` | string | - | Replacement image for the "bug" position in the reaction feature. Only supports images from the repository's default branch, using a relative path from the repository root |

:::tip
Custom images only support files from the repository's default branch. Simply provide the relative path from the repository root.
:::