.. include:: /Includes.rst.txt .. _ctrl-reference-label: ===== label ===== .. confval:: label :name: ctrl-label :Path: $GLOBALS['TCA'][$table]['ctrl'] :type: string (field name) :Scope: Display **Required!** Points to the field name of the table which should be used as the "title" when the record is displayed in the system. .. note:: :ref:`label_userFunc ` overrides this property (but it is still required). .. warning:: For the label only regular input or text fields should be used. Otherwise issues may occur and prevent from a working system if :code:`TCEMAIN.table.tt_content.disablePrependAtCopy` is not set or set to :code:`0`. A simple example ---------------- .. include:: /Images/Rst/TxStyleguideCtrlMinimal.rst.txt .. include:: /CodeSnippets/TxStyleguideCtrlMinimal.rst.txt .. _ctrl-reference-label-alt: label\_alt ========== .. confval:: label_alt :name: ctrl-label-alt :type: String (comma-separated list of field names) :Scope: Display Comma-separated list of field names, which are holding alternative values to the value from the field pointed to by "label" (see above) if that value is empty. May not be used consistently in the system, but should apply in most cases. .. note:: :ref:`label_userFunc ` overrides this property, also see :ref:`label_alt_force `. Examples -------- Example for table "tt\_content":: 'ctrl' => [ 'label' => 'header', 'label_alt' => 'subheader,bodytext', ], .. _ctrl-reference-label-alt-force: label\_alt\_force ================= .. confval:: label_alt_force :name: ctrl-label-alt-force :type: boolean :Scope: Display If set, then the :ref:`label ` field and the :ref:`label_alt ` fields are shown in the title separated by comma. .. note:: :ref:`label_userFunc ` overrides this property.