---
title: "GravityExport field: SeparableField"
date: 2026-04-23
author: "GravityKit"
link: "https://www.gravitykit.com/docs/gravityexport/gravityexport-field-separablefield/"
---

A bunch of form fields are multipart fields. Fields like `name` , `address` , `creditcard` all have multiple inputs, and can therefor be either in a single column, combined by a newline, or be split up into multiple columns. This class is responsible for splitting up these inputs in to multiple columns.

The `Transformer` checks if a field has multiple inputs, and if so chooses `SeparableField` by default.

## Filters

- `gfexcel_field_separated_{type}_{form_id}_{field_id}`
    
    Using this filter you can enable or disable the separability of a specific field. Just use the `__return_true` and `__return_false` functions from Wordpress for this.
- `gfexcel_field_label_{type}_{form_id}_{field_id}`
    
    This filter is a default filter for all fields, but here it can be used to manipulate the label for every column. By default the label is the same as the field name, unless you’ve provided a custom label on the field.
- `gfexcel_field_value_{type}_{form_id}_{field_id}`
    
    This filter is also the default filter for a field, but it now also targets every column available for this field.
- `gfexcel_field_*type*_fields`
    
    This is a bit of an odd (named) filter. You can use it to change the input this field has. But because the `type` is actually necessary to target the correct field, this isn’t an optional piece. That’s why I’ve contained it IN the name of the filter. So just update `*type*` to something like `address` or `name` .

## Example

```
add_filter('gfexcel_field_address_fields', function( $fields, $entry ) { 
  //manipulate these fields 
  return $fields; 
}, 10, 2);
```

```
add_filter('gfexcel_field_address_fields', function( $fields, $entry ) { 
  //manipulate these fields 
  return $fields; 
}, 10, 2);
```

## Extendability

This class is the base for all multiple input fields, and it is great for extension if you have a (custom) separable field. Please see [ProductField](/docs/gravityexport/gravityexport-field-productfield/), as this is an extension of `SeparableField` .