---
id: gform_abilities_definitions
title: "Filter - gform_abilities_definitions"
sidebar_label: "gform_abilities_definitions"
tags:
  - "3.1.0"
---

# Filter: gform_abilities_definitions

Filters all ability definitions before per-definition processing.

Add-ons can add, remove, or reorder definitions. The capability and execute callback of a core ability stay immutable, so a filter cannot weaken a shipped ability.

## Parameters

| Name | Type | Description |
|------|------|-------------|
| $raw_definitions | `array[]` | Array of raw definition arrays, each with 'name' and 'args' keys. |

## Example

```php
add_filter( 'gform_abilities_definitions', function( $definitions ) {
    $definitions[] = [
        'name' => 'gravityforms/myaddon/my-action',
        'args' => [
            'label'            => __( 'My Action', 'gravityforms-myaddon' ),
            'description'      => __( 'Does something useful.', 'gravityforms-myaddon' ),
            'summary'          => __( 'Short, plain-language line shown as the settings tooltip.', 'gravityforms-myaddon' ),
            'capability'       => 'gravityforms_edit_forms',
            'execute_callback' => [ $this, 'handle_my_action' ],
        ],
    ];
    return $definitions;
} );
```

### Since

- 3.1.0

### Source

Defined in `includes/abilities/class-gf-abilities-registry.php` at line 76


## Returns
Filtered array of raw definition arrays.