---
title: Child Reports
slug: reports/child-reports
description: Create child reports in Unaric Reports to show detailed breakdowns linked to parent report records.
docTags: 
createdAt: 2026-02-12T18:49:16.255Z
---

Child reports allow you to include related records from a secondary report inside a Document Template. For example, you might generate an Account document that includes a list of related Contacts or Opportunities.

## How it works

Child reports can be formatted using:

- [Record Handlers](docId\:ANAb32VNqVreBiUwYxfYm) to control the layout of child reports. For example, you can configure a template to create a separate page for each parent record (such as an Account) and a distinct block or section for each child record (such as their Contacts) associated with that parent.
- [Report template tables](docId\:R6-zCeZbhY1RKvTlRToXV) as the anchor for mapping and formatting complex data.

Child reports work like standard reports, except they use a combined alias format `PARENT_ALIAS.CHILD_ALIAS`. You can find the alias for the child (which is the relationship name), on either the parent report detail page or on the detail page of the child report.

::::VerticalSplit{layout="middle"}
:::VerticalSplitItem
**Parent report alias**

![](https://api.archbee.com/api/optimize/10Nod6Ww95R3dPr0k0TCJ/VDXgPPcl8WPejkcdlKShT_parent-report-alias.png)
:::

:::VerticalSplitItem
**Child report alias**

![](https://api.archbee.com/api/optimize/10Nod6Ww95R3dPr0k0TCJ/TfeJ-5sF8plejA15pP08q_child-report-alias.png)
:::
::::

## Method 1: Child Record Handlers

You can format child report data using:

- Block Record Handler 
- Cell Record Handler 

These work exactly like standard record handlers except for the alias format described above.

### Example

Suppose your template generates an Account document using a Page Record Handler and you want to include a list of related Contacts. 

1. Identify the parent and child aliases. 
2. Add a child record handler using: 

:::BlockQuote
PARENT\_ALIAS.CHILD\_ALIAS
:::

::Image[]{src="https://api.archbee.com/api/optimize/10Nod6Ww95R3dPr0k0TCJ/bj_H-1nY_7k_VCGSR8aDU_child-report-record-handler.png" size="64" width="698" height="445" position="center" showCaption="false"}

3. Place child variables inside the handler block. 
4. When the Solution runs, the document will merge in the fields and repeat a block (or cell) for each related child record.

::Image[]{src="https://api.archbee.com/api/optimize/10Nod6Ww95R3dPr0k0TCJ/jnYD2gjqeVnhsO_E3Ev80_child-report-record-handler-output.png" size="68" width="737" height="481" position="center" showCaption="false"}

## Method 2: Child Report Template Tables

Child Reports can be formatted using report template tables. Works the same as standard report template tables, with the difference of requiring placing the table inside a cell of the main template.

### Example

If generating an Account document:

1. Embed a report template table for related Contacts inside the template 
2. Use the same `PARENT_ALIAS.CHILD_ALIAS` format. 

::Image[]{src="https://api.archbee.com/api/optimize/10Nod6Ww95R3dPr0k0TCJ/yANK5bY-hUq8EIQ7prQgY_child-report-report-template.png" size="62" width="679" height="474" position="center" showCaption="false"}

3. The table populates automatically with related child records when the Solution runs.

::Image[]{src="https://api.archbee.com/api/optimize/10Nod6Ww95R3dPr0k0TCJ/YSqRVOZ8RzrszL5ahtsI2_child-report-report-template-output.png" size="60" width="681" height="423" position="center" showCaption="false"}