---
url: /en/repo/settings-workspace.md
description: >
  Customize the cloud-native development launch button via .cnb/settings.yml,
  including name, description, hover image, CPU configuration, and disable
  option.
---
Customize the appearance and behavior of the cloud-native development launch button to make your project stand out.

## Use Cases

* Create a unique launch experience for open-source projects
* Highlight the development environment features of your project
* Control resource configuration of the development environment (e.g. CPU cores)
* Disable the default launch button (e.g., when using a custom pipeline instead)

## Configuration

Add the `workspace` configuration to `.cnb/settings.yml` in the branch where the launch button is located:

```yaml title=".cnb/settings.yml"
workspace:
  launch:
    button:
      name: Launch Cloud-Native Development
      description: Click this button to launch the cloud-native development environment
      hoverImage: .cnb/launch-hover.gif
    cpus: 4
    disabled: false
    autoOpenWebIDE: false
```

## Parameter Reference

| Parameter                            | Type    | Default | Description                                       |
| ------------------------------------ | ------- | ------- | ------------------------------------------------- |
| `workspace.launch.button.name`       | string  | -       | The name of the launch button                     |
| `workspace.launch.button.description`| string  | -       | Button description                                |
| `workspace.launch.button.hoverImage` | string  | -       | Hover image (repo relative path or URL, ≤10MB)    |
| `workspace.launch.cpus`              | number  | 8       | CPU cores, only effective for the default template |
| `workspace.launch.disabled`          | boolean | false   | Whether to disable the default launch button      |
| `workspace.launch.autoOpenWebIDE`    | boolean | false   | Whether to auto-open WebIDE after creation        |

**Notes:**

* **`description`**: Set to `null` to hide the button description.
* **`hoverImage`**: Supports a repository relative path or a raw URL.
  The image is displayed when the user hovers over the launch button.
  Maximum file size is 10MB.
* **`autoOpenWebIDE`**: Once the cloud-native development environment is
  successfully created, the WebIDE opens automatically in the browser
  without additional user action.

:::tip
All parameters are optional. Configure only what you need.
:::