# Button Base

> Render a single Varavel-styled button or link inline.

Canonical HTML: https://press.varavel.com/docs/shortcodes/button-base/
Markdown: https://press.varavel.com/docs/shortcodes/button-base/index.md

`button_base` renders one button-style element using the shared button macro. Use it for inline actions inside documentation pages, compact CTAs, or custom Markdown sections.

## When to Use

Use `button_base` when you need one action and do not need a full CTA section. It can render as an `<a>` when `href` is provided or as a button-style element when it is not.

## Usage

```markdown
{{/* button_base(
text="Open documentation",
href="/docs/",
variant="solid",
color="neutral",
icon_right="arrow-right"
) */}}
```

## Live Example

{{ button_base(
text="Open documentation",
href="/docs/",
variant="solid",
color="neutral",
icon_right="arrow-right"
) }}

## Parameters

| Parameter    | Description                                                          |
| ------------ | -------------------------------------------------------------------- |
| `text`       | Button label. Required.                                              |
| `href`       | Optional URL. When present, the shortcode renders a link.            |
| `target`     | Optional link target, such as `_blank`.                              |
| `variant`    | Visual style: `solid`, `outline`, or `ghost`.                        |
| `color`      | Semantic color: `neutral`, `info`, `success`, `warning`, or `error`. |
| `size`       | Button size: `sm`, `md`, or `lg`.                                    |
| `icon`       | Optional icon rendered before the label.                             |
| `icon_right` | Optional icon rendered after the label.                              |
| `radius`     | Border radius: `sm`, `md`, `lg`, or `full`.                          |
| `wide`       | Set to `true` to make the button full width.                         |
| `disabled`   | Set to `true` to disable interaction.                                |
| `type`       | Button type when no `href` is provided. Defaults to `button`.        |
| `class`      | Additional CSS classes appended to the rendered element.             |