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

# Filter: gform_ability_definition

Filters a single ability definition after normalization.

A filter can change properties such as label, description, or schema. The name, permission_callback, ability_class, and execute_callback stay immutable, so a filter cannot weaken the capability gate or replace the callback.

## Parameters

| Name | Type | Description |
|------|------|-------------|
| $definition | `array` | The normalized ability definition. |
| $name | `string` | The ability name (e.g. 'gravityforms/system-info'). |

## Example

```php
add_filter( 'gform_ability_definition', function( $definition, $name ) {
    if ( $name === 'gravityforms/forms-delete' ) {
        $definition['label'] = __( 'Trash Form', 'gravityforms' );
    }
    return $definition;
}, 10, 2 );
```

### Since

- 3.1.0

### Source

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


## Returns
The filtered ability definition.