Practicalweb Ltd

Technical information on this site may be out of date : no updates since 2015

Instance parameter for drupal field_create_instance($instance)

September 23 2011 : posted under drupal drupal 7 errata

The code in chapter 7 of pro Drupal development has a bug.

The $instance array that you need to pass to field_create_instance() needs to be as below.

Note that the display array has the keyword, ‘default’ for the default display - ie a node on it’s own page ‘teaser’ looks like the right value for teaser. Other view modes are possible too.

The label field in the display part of the array is just the positioning of the array - ‘above’, ‘below’, ‘inline’ and ‘hidden’ seem the likely set of allowed values.

NB the display part of the array is optional as Drupal will provide default values.


        'field_name' => 'job_post_company',
        'type'       => 'text',
        'label'      => $t('Company posting the job listing'),
        'widget'     => array(
                   'type' => 'text_textfield',
        'display' => array(
           'default' => array(
               'label' => 'above',
               'type'  => 'text',

The errata for this book seems to be long and unhelpfully laid out 563 reported errors so far…

There even seems to be errors in the errata seems to report this error (or part of it) but I think it’s wrong - the array key should be a view mode.