Create and Replace Custom Fields in Reports
Overview
How do I add and update custom placeholders in reports?
Custom fields in CxPlanner reports allow you to create placeholders that can be replaced with specific text across the entire report in one action. This is useful when you need to update recurring names, titles, or project data without editing each occurrence manually.
When and why to use this
You should use custom fields when you want consistent text values across your reports and the flexibility to update them quickly.
- Use when a name, role, or data point is repeated in multiple places.
- The system replaces all occurrences of the placeholder in the report at once.
- Ideal for items like Project Manager name, Client company, or Inspection date.
- Updates apply instantly to all designated locations in the report.
Guide - How to Create and Replace Custom Fields in Reports
Create a custom field
- In your report template, type your placeholder text between two curly braces with spaces inside, e.g.
{{ Project Manager }}
- Repeat this for any additional placeholders you want to define.
Update a custom field in a project report
- Open the report in your project.
- Click the yellow Replace template text button.
- Enter the new value for the placeholder.
- Confirm to update all matching fields in the report.
Behavior and results
- Placeholders must have spaces inside the curly braces to be recognized.
- Updating a placeholder affects all instances of it in the report.
- You can define multiple custom fields in the same report template.
- Replacements are applied in the project-level report, not in the original template.
Troubleshooting
Problem | Cause | Solution |
---|---|---|
Placeholder not detected | Missing spaces inside curly braces | Use |
Replace button not visible | Report does not contain any valid placeholders | Add at least one correctly formatted placeholder |
Only some fields updated | Fields use slightly different text or formatting | Ensure all placeholders match exactly |
Quick facts
- Requires: Project role Manager or higher
- Location: Reports → Report template editing / Project report view
- Affects: All matching placeholders in the report
Keywords: custom fields, report placeholders, replace text, report editing, template fields, update report data
Updated on: 08/14/2025
Thank you!