Skip to main content

Output Best Practices

A well-designed output presents data clearly, loads quickly, and generates accurately into PDF and Excel. These practices help designers avoid the most common layout, performance, and formatting pitfalls.

Output best practices

Design for the audience first

Before opening the Output Designer, answer:

  • Who reads this report? (Executive / technical / client / regulator)
  • What decisions does it support?
  • What format will they use it in? (PDF print / on-screen interactive / Excel download)

The answers determine component choices, information density, and color usage.


Page structure

PracticeReason
Page 1 should be a summaryPut key KPIs, RAG indicators, and headline narrative on the first page. Readers may not go further.
Use consistent page marginsApply the same margins to all pages via Page Layout → Apply to all pages. Inconsistent margins break PDF alignment.
Name every pageNamed pages appear in PDF bookmarks, navigation buttons, and the page thumbnail panel.
Limit each page to one main storyAvoid putting unrelated components on the same page. One page = one reporting theme.
Use a consistent header/footer templateApply the same header (logo, report title, page number) and footer (issue date, version, confidentiality) to all pages.

Component choices

ScenarioRecommended component
Showing many activities with timelinesGantt
Comparing a metric to a targetKPI card with comparison layout
Trend over timeLine chart or cash flow curve
Composition of a totalStacked bar or pie/donut
Category rankingHorizontal bar chart
Multi-row data with filteringTable with conditional formatting
Cross-tab aggregationMatrix
Project location or site dataMap
Schedule driftMilestone Trend Analysis
Earned value metricsEarned value chart
Cost to completionCash flow curve

Avoid using a chart type that looks impressive but requires explanation. If the reader needs a legend and a title and a footnote to understand it, simplify.


Data binding

PracticeReason
Bind all required wells before formattingFormatting a component before binding wastes time if the data shape changes the layout.
Preview with real edition dataUse a representative edition with realistic volume. Small test editions hide performance and overflow problems.
Do not use more than 3 grouping levels in a tableThree levels of group nesting is the practical readability limit. Split into multiple tables if more are needed.
Limit chart series to \u2264 8More than 8 series on a single chart is difficult to read. Use a filter or group lesser series into "Other".
Use calculated fields for labelsCalculated fields like CONCAT([Code], \" - \", [Name]) create clean labels without changing the underlying data.

Formatting

PracticeReason
Use the report theme for colorsConsistent colors across components make the report look professional. Only override for specific semantic purposes (e.g., RAG red).
Reserve red for negative/overrun, green for positive/on-trackThese color associations are universal in project reporting. Do not use red for decoration.
Use number format abbreviation for large numbersDisplay 4,500,000 as 4.5M to reduce visual clutter.
Align numbers right, text leftThis is the standard table convention. Misalignment looks like a mistake.
Set a min/max on chart axes only when necessaryAuto-scaling is usually best. Manual min/max can visually exaggerate or suppress variation.

Performance

PracticeReason
Avoid binding the same section to > 10 components on one pageEach binding is a separate data query. High binding counts slow generation.
Use page-scope filters to limit data earlyFiltering at page scope reduces the data each component must process.
Use the Matrix component instead of a wide Table for cross-tab dataMatrix generates the pivot at the output level; a manually pivoted table requires pre-pivoted source data.
Limit Map components to 1 per output if using geocodingGeocoding adds latency. Cache is per report run; multiple maps re-geocode the same points.

PracticeReason
Preview in Print mode before publishingSwitch to Print preview in View tab to confirm nothing overflows the page margins.
Avoid freeform component overlapOverlapping components in PDF may not render as expected \u2014 PDF rendering is z-order sensitive.
Add page breaks before major sectionsUse Insert → Page break to ensure sections start on a new page.
Test with the largest realistic datasetTables and Gantt charts that fit on one page with 20 rows may span 5 pages with 200 rows.