$fields->findByTag() method

Return all fields that have the given $tag

Returns an associative array of ['field_name' => 'field_name'] if $getFieldNames argument is true, or ['field_name => Field instance] if not (which is the default).

Available since version 3.0.106.

Usage

// basic usage
$array = $fields->findByTag(string $tag);

// usage with all arguments
$array = $fields->findByTag(string $tag, bool $getFieldNames = false);

Arguments

NameType(s)Description
tagstring

Tag to find fields for

getFieldNames (optional)bool

If true, returns array of field names rather than Field objects (default=false).

Return value

array

Array of Field objects, or array of field names if requested. Array keys are always field names.


$fields methods and properties

API reference based on ProcessWire core version 3.0.248

Latest news

  • ProcessWire Weekly #581
    The 581st issue of ProcessWire Weekly brings in all the latest news from the ProcessWire community. Modules, sites, and more. Read on!
    Weekly.pw / 28 June 2025
  • New ProcessWire admin redesign
    When you upgrade to ProcessWire 3.0.248 or newer (currently the dev branch), you’ll immediately notice something new and beautiful…
    Blog / 9 May 2025
  • Subscribe to weekly ProcessWire news

I just love the easy and intuitive ProcessWire API. ProcessWire rocks!” —Jens Martsch, Web developer