---
url: /en/workspaces/custom-dev-button.md
description: >
  Explains how to customize the Workspaces launch button by adding a
  `.cnb/settings.yml` configuration file to the repository.
---
You can customize the Workspaces launch button name, description,
hover image, and CPU core count.

The configuration file is `.cnb/settings.yml` in the repository root of the default branch.
The following is a complete example:

```yaml title=".cnb/settings.yml"
workspace:
  launch:
    button:
      name: Launch Cloud-Native Development
      description: Enter the online coding environment with one click
      hoverImage: .cnb/launch-hover.gif
    cpus: 8
    disabled: false
    autoOpenWebIDE: false
```

For the fields you can customize and detailed explanations of other parameters
(such as auto-opening WebIDE after creation, disabling the button, and more),
see [Workspaces Launch Button Customization](../repo/settings-workspace.md).