Documentation/Publish content
Free

Display fields & fix output

Show text, images and repeaters. Solve missing values and raw IDs.

On this page

Show saved fields on the page

Choose Use your fields in a saved field group to get the matching block or shortcode. Enter values in the matching WordPress editor and save the content before checking the result.

  • Text: add the Custom field block or a shortcode such as [customfield name="project_title"].
  • Images, files and galleries: use the Custom field block or [customfield name="project_image" format="html"]. Replace the example name with your field name. A plain image shortcode keeps its original attachment ID output.
  • Repeater rows: insert the Custom field repeater block, select the repeater and the direct child fields to show, then choose List or Table. Save field values to refresh its preview. A plain repeater shortcode does not render a collection.

Nested groups, flexible layouts and reference names need an appropriate template. The html format accepts uppercase and surrounding spaces. Unsupported formats such as format="url" keep legacy output; an image may therefore display its attachment ID. Use the field guide's generated shortcode for formatted media. The output respects current media access checks, but this does not protect direct upload URLs or remove already cached copies.

Choice labels: saved-field blocks and formatted shortcodes display stored keys for single-select and radio fields, and configured labels for multiselect and checkbox choices. Named blocks' own select controls display their configured labels. Use a template when another presentation is needed.

URL values: enter a complete https:// or http:// URL. PHP and REST integrations should also send absolute URLs rather than rely on automatic normalization.

Project details rendered by CustomFields in a sample WordPress theme
Genuine Free 1.2.5 output. The example theme and content are not included. Select the image to enlarge.

Common display problems

My image shows a number.
Use the Custom field block or [customfield name="project_image" format="html"]. Replace the example name with your actual field name. Plain output intentionally keeps the attachment ID.
My repeater is blank.
Use the Custom field repeater block, select its direct child fields and choose List or Table. Enter and save actual rows first. A plain repeater shortcode does not render rows.
The preview is empty or out of date.
Save the record’s field values, then check again. The builder’s sample values and the display block’s saved-content preview are different things.
I cannot find my fields in the editor.
Check the group’s content location, post type and any specific-post or template rules. Open the editor’s CustomFields.com panel and select Open fields.
Save is disabled after editing a field.
In 1.2.5, open Meta Boxes and look for a validation message. Correct required or invalid values and try again. More than one field may need correction.
A choice or reference shows a key or ID.
Single-select and radio values retain their stored keys. References need a template for names or linked cards. See the public-post relationship example.
Private media does not appear.
Check the attachment and parent content’s visibility and your permissions. Do not remove access checks to force output. Direct upload URLs and cached copies need separate protection.