# December 15, 2025

## Custom page actions

Define custom page action buttons with your own titles, icons, and URLs. Custom actions appear alongside the built-in page actions like Copy Page and View as Markdown, and can link to external tools, editors, or any URL.

```yaml docs.yml
page-actions:
  options:
    custom:
      - title: Open in Windsurf
        subtitle: Edit with AI assistance
        url: "windsurf://open?url={url}"
        icon: fa-solid fa-wind
        default: true
```

Custom actions support URL placeholders like `{slug}`, `{domain}`, and `{url}` to dynamically insert page information into the link.

[Learn more](/learn/docs/configuration/site-level-settings#custom-page-actions) about configuring custom page actions.