I am trying to add a custom label to an apex:outputField tag but when I do the help text disappears. How do I change the label but keep the help text?

The VF snippet below displays the same field three different ways. The first two uses a custom label and the third is the normal apex:outputField which will use the label from the SObject field. The output is shown below the code.

    <apex:pageBlockSection title="Balances" columns="1">

        <apex:pageBlockSectionItem >
            <apex:outputLabel value="My Label"/>
            <apex:outputField value="{!sob.Balance__c}"/>

        <apex:outputField value="{!sob.Balance__c}" label="My Label"/>

        <apex:outputField value="{!sob.Balance__c}"/> 


Here is the output. The help text only appears on the third field.


2 Answers 2


The solution is easy. Just use the helpText attribute of the apex:pageBlockSectionItem and put the help info from the field in it:

<apex:pageBlockSectionItem helpText="{!$ObjectType.Account.fields.Street__c.InlineHelpText}">
    <apex:outputLabel value="My Label"/>
    <apex:outputField value="{!a.Street__c}"/>


This is not a bug and works as designed and discussed in above document .

Note that if you include an <apex:outputField> or an <apex:inputField> component in an <apex:pageBlockSectionItem>, these components do not display with their label or custom help text as they do when they are children of an <apex:pageBlockSection>. Also note that <apex:pageBlockSectionItem> components can't be rerendered; rerender the child components instead.

  • Does the same hold true for <apex:outputField value="{!sob.Balance__c}" label="My Label"/>?
    – BarCotter
    Nov 28, 2013 at 17:25
  • Yes i observed the same behaviour .I think mast0r has right work around Nov 28, 2013 at 17:39

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .