Note: This release is in preview. Features described here don’t become generally available until the latest general availability date that Salesforce announces for this release. Before then, and where features are noted as beta, pilot, or developer preview, we can’t guarantee general availability within any particular time frame or at all. Make your purchase decisions only on the basis of generally available products and features.

apex:pageMessages

This component displays all messages that were generated for all components on the current page, presented using the Salesforce styling.

Use this component to get user input for a controller method that does not correspond to a field on an sObject. Only <apex:inputField> and <apex:outputField> can be used with sObject fields.

Example

1<apex:page standardController="Opportunity" recordSetVar="opportunities"
2    tabStyle="Opportunity" sidebar="false">
3    <p>Enter an alphabetic character for the "Close Date," 
4       then click Save to see what happens.</p>
5    <apex:form >
6        <apex:pageBlock >
7        <apex:pageMessages />
8        <apex:pageBlockButtons >
9            <apex:commandButton value="Save" action="{!save}"/>
10        </apex:pageBlockButtons>
11            <apex:pageBlockTable value="{!opportunities}" var="opp">
12                <apex:column value="{!opp.name}"/>
13                <apex:column headerValue="Close Date">
14                    <apex:inputField value="{!opp.closeDate}"/>
15                </apex:column>
16            </apex:pageBlockTable>
17        </apex:pageBlock>
18    </apex:form>
19</apex:page>

Attributes

Attribute Name Attribute Type Description Required? API Version Access
escape Boolean A Boolean value that specifies whether sensitive HTML and XML characters should be escaped in the HTML output generated by this component. If you do not specify escape="false", the character escape sequence displays as written. Be aware that setting this value to "false" may be a security risk because it allows arbitrary content, including JavaScript, that could be used in a malicious manner. 14.0
id String An identifier that allows the component to be referenced by other components in the page. 14.0 global
rendered Boolean A Boolean value that specifies whether the component is rendered on the page. If not specified, this value defaults to true. 14.0 global
showDetail Boolean A Boolean value that specifies whether to display the detail portion of the messages. If not specifed this value defaults to false. 14.0