The Problem
A page item you created in Page Designer does not appear on the rendered page, appears in the wrong location, or renders with incorrect formatting.
Check 1: Region Assignment
Every page item must be assigned to a region. If the item’s Region property is empty or set to a region that has a server-side condition evaluating to false, the item will not render. In Page Designer, check the item’s Layout section to confirm it is assigned to a visible region.
Check 2: Server-Side Condition
The item itself may have a Server-side Condition that is preventing it from rendering. Check the item’s Condition property. A common mistake is setting a condition like “Value of Item P10_MODE = EDIT” when P10_MODE has not been set yet during page rendering, causing the condition to evaluate to false.
Check 3: Template and Label Position
If the item renders but looks wrong (label missing, odd spacing, wrong size), check its Template, Label Column Span, and Field Column Span properties. For items to align properly in a two-column layout, the label and field spans must add up to 12 (the grid total). Template = “Optional – Floating” is the standard Universal Theme template for most items.
Check 4: Authorization Scheme
If the item has an Authorization Scheme that the current user does not satisfy, the item is not rendered. This is by design but can be confusing during development. Check the item’s Security, then Authorization Scheme property. Test by logging in as a user who has the required role.
Check 5: Hidden Items
If the item’s Type is “Hidden,” it exists in the page HTML but is not visible. This is correct behavior for hidden items. If you intended it to be visible, change the Type to the appropriate visible type (Text Field, Select List, etc.).
Check 6: CSS or JavaScript Hiding the Item
Custom CSS or JavaScript might be hiding the item. Inspect the item in the browser’s DevTools and check for display: none, visibility: hidden, or a parent element that is hidden. Look for Dynamic Actions that might be hiding the item on page load.
Layout Debugging Tip
In the APEX Developer Toolbar, click “Show Layout” to see the grid structure of the page with region boundaries and column spans highlighted. This makes it immediately obvious where items are placed and whether they are inside the expected region.