function field_info_instance

7.x field_info_instance($entity_type, $field_name, $bundle_name)

Returns an array of instance data for a specific field and bundle.

The function populates a static cache with all fields and instances used in the bundle, allowing fast retrieval of field_info_field() or field_info_instance() later in the request.


$entity_type: The entity type for the instance.

$field_name: The field name for the instance.

$bundle_name: The bundle name for the instance.

Return value

An associative array of instance data for the specific field and bundle; NULL if the instance does not exist.

Related topics

43 calls to field_info_instance()
CommentTokenReplaceTestCase::testCommentTokenReplacement in drupal/modules/comment/comment.test
Creates a comment, then tests the tokens generated from it.
comment_tokens in drupal/modules/comment/
Implements hook_tokens().
DisabledNodeTypeTestCase::testDisabledNodeTypeUpgrade in drupal/modules/simpletest/tests/upgrade/upgrade.node.test
Tests a successful upgrade.
FieldAttachStorageTestCase::testFieldAttachCreateRenameBundle in drupal/modules/field/tests/field.test
Test field_attach_create_bundle() and field_attach_rename_bundle().
FieldAttachStorageTestCase::testFieldStorageDetailsAlter in drupal/modules/field/tests/field.test
Test storage details alteration.

... See full list


drupal/modules/field/, line 623
Field Info API, providing information about available fields and field types.


function field_info_instance($entity_type, $field_name, $bundle_name) {
  $cache = _field_info_field_cache();
  $info = $cache->getBundleInstances($entity_type, $bundle_name);
  if (isset($info[$field_name])) {
    return $info[$field_name];