---
url: /reference/default-theme-carbon-ads.md
description: >-
  Integrate Carbon Ads into your VitePress site using the default theme's
  built-in support.
---

# Carbon Ads

VitePress has built in native support for [Carbon Ads](https://www.carbonads.net/). By defining the Carbon Ads credentials in config, VitePress will display ads on the page.

```js
export default {
  themeConfig: {
    carbonAds: {
      code: 'your-carbon-code',
      placement: 'your-carbon-placement',
      format: 'classic'
    }
  }
}
```

These values are used to call carbon CDN script as shown below.

The `format` option supports `classic`, `responsive`, and `cover`.

```js
`//cdn.carbonads.com/carbon.js?serve=${code}&placement=${placement}&format=${format}`
```

To learn more about Carbon Ads configuration, please visit [Carbon Ads website](https://www.carbonads.net/).