# customButtons

> FullCalendar v4 documentation, for an old release. Web version: https://legacy.fullcalendar.io/v4/customButtons
>
> Latest version (v7): https://fullcalendar.io/docs/buttons.md

Defines custom buttons that can be used in the header/footer.

<div class='spec' markdown='1'>
Object
</div>

Specify a hash of custom buttons. Then reference them from the `header` setting. Like this:

```js
var calendar = new Calendar(calendarEl, {
  customButtons: {
    myCustomButton: {
      text: 'custom!',
      click: function() {
        alert('clicked the custom button!');
      }
    }
  },
  header: {
    left: 'prev,next today myCustomButton',
    center: 'title',
    right: 'dayGridMonth,timeGridWeek,timeGridDay'
  }
});
```

Each `customButton` entry accepts the following properties:

- `text` - the text to be display on the button itself
- `click` - a callback function that is called when the button is clicked. Accepts a single argument, a [JavaScript native event](https://developer.mozilla.org/en-US/docs/Web/API/UIEvent).
- `icon` - see [buttonIcons](https://legacy.fullcalendar.io/v4/buttonIcons.md). optional
- `bootstrapFontAwesome` - see [bootstrapFontAwesome](https://legacy.fullcalendar.io/v4/bootstrapFontAwesome.md). optional

[See a demo of customButtons](https://legacy.fullcalendar.io/v4/toolbar-demo).