---
source: https://carbone.io/examples/fund-factsheet/
title: "Fund Reporting Software API: Fund Factsheet PDF | Carbone"
description: "Generate monthly UCITS fund factsheets from your portfolio system with the Carbone API: NAV, performance vs benchmark, holdings, risk indicator, costs, charts."
generated_at: "2026-11-17"
---

# Monthly fund factsheet

NAV, performance, holdings and risks on a 2-page UCITS factsheet

[![Monthly fund factsheet: PDF generated from an HTML template and JSON data](/examples/fund-factsheet/thumb-result.webp)](/examples/fund-factsheet/result.pdf "Download the generated document")

[Download template](/examples/fund-factsheet/template.md)

[Sample data](/examples/fund-factsheet/data.json)

[Download the generated PDF](/examples/fund-factsheet/result.pdf)

- **Template:** HTML
- **Export as:** PDF, HTML, PNG, WebP [+7 more](/documentation/developer/http-api/generate-reports.md#output-file-type)
- **Carbone:** 5.18+

Features

-   [HTML](/documentation/design/advanced-features/html.md)
-   [Loop](/documentation/design/repetitions/with-arrays.md)
-   [Aggregation](/documentation/design/computation/aggregation.md)
-   [Set](/documentation/design/computation/store-and-transform.md)
-   [Condition](/documentation/design/conditions/overview.md)
-   [Number](/documentation/design/formatters/number.md)
-   [Currency](/documentation/design/formatters/currency.md)
-   [Chart](/documentation/design/advanced-features/charts.md)
-   Header and footer

## Generate fund factsheets from your portfolio system

Asset managers publish a factsheet for every share class of every fund each month, a few days after the month ends, on their website, on fund platforms and for their distributors. The portfolio management system and the fund administrator hold the data: net asset values, benchmark levels, holdings, allocations and costs. A reporting job sends it to the Carbone API as JSON, once per share class and language, and gets back the PDF.

In this example, Lindenhart Asset Management, a fictional Luxembourg management company, publishes the factsheet of the A EUR Acc share class of its European equity fund, a UCITS, as at 30 September 2026. A factsheet is a marketing communication: the [ESMA guidelines on marketing communications](https://www.esma.europa.eu/sites/default/files/library/esma34-45-1272_guidelines_on_marketing_communications.pdf) and [Article 4 of Regulation (EU) 2019/1156](https://eur-lex.europa.eu/eli/reg/2019/1156/oj) ask it to say so, to give the risks the same prominence as the benefits, and to tell investors where, how and in which language they can get the prospectus, the key information document (KID) and the summary of investor rights.

The past performance follows the same guidelines: the warning "Past performance does not predict future returns" before the figures, every complete calendar year since launch next to the cumulative chart, the benchmark of the KID, and a year-to-date return at the end of the most recent quarter. The risk indicator and the costs are those of the [PRIIPs KID](https://eur-lex.europa.eu/eli/reg_del/2017/653/oj), and the sustainability section states the fund's classification under [SFDR](https://eur-lex.europa.eu/eli/reg/2019/2088/oj), here Article 8.

In this example, you will:

-   Format the net asset value, the fund size and the costs with `:formatC` and `:formatN`
-   Print the returns and weights of the data, stored as decimals, as percentages
-   Repeat the return rows, the calendar years and the top 10 holdings in loops
-   Highlight the risk indicator and keep the paragraph of the SFDR article with conditions
-   Draw the performance and allocation charts with ECharts
-   Lay out two A4 pages with a footer on each page

## The factsheet, section by section

| Section | Content | What Carbone does |
| --- | --- | --- |
| Header | "Marketing communication" label, fund, share class, ISIN, ESMA disclaimer | Formats the reporting date with `:formatD` |
| Key figures | NAV per share, fund size, launch date, ongoing costs, SFDR article | Formats the amounts with `:formatC`, adds up the ongoing costs once with `:set` |
| Objective and risk indicator | Investment policy, use of the benchmark, risk class of the KID from 1 to 7 | Highlights the risk class with an inline condition |
| Potential benefits and risks | Two lists side by side, in the same font size | Repeats the items in two loops |
| Performance | Warning, cumulative chart, cumulative and annualized returns, volatility, calendar years | Draws the chart with ECharts, repeats rows and columns in loops |
| Portfolio | Top 10 holdings, sector and country allocation, manager commentary | Totals the top 10 with `:aggSum`, draws two bar charts |
| Fund facts, costs, sustainability | Management company, depositary, costs of the KID, SFDR disclosure | Computes the cost example, keeps the paragraph of the SFDR article |
| Important information | Where to get the documents and in which languages, investor rights, end of marketing | Prints the links of the data |

## How to build a fund factsheet in HTML

### 1\. Set Up the Pages and the Footer

Write the factsheet as an HTML page with its CSS in a `<style>` block, in a font installed everywhere, like Arial. Set the A4 page and its margins with the [PDF options](/documentation/design/template-formats/html.md#pdf-conversion-options), and repeat the fund, the date and the "Marketing communication" label on every page in the [footer](/documentation/design/template-formats/html.md#headers-footers). The second page starts with a [page break](/documentation/design/template-formats/html.md#page-breaks):

```html
<carbone-pdf-options paper-size="A4" print-background="true" display-header-footer="true" margin-top="0.45" margin-bottom="0.6" margin-left="0.55" margin-right="0.55"/>

<carbone-pdf-header><div></div></carbone-pdf-header>
<carbone-pdf-footer>
  <div>{d.fund.name}, {d.shareClass.name} · Monthly factsheet as at {d.document.asOf:formatD('D MMMM YYYY')} · Marketing communication</div>
  <div>Page <span class="pageNumber"></span> of <span class="totalPages"></span></div>
</carbone-pdf-footer>
```

### 2\. Format the Key Figures

[`:formatC`](/documentation/design/formatters/currency.md) prints the amounts in the currency of the report. The fund size is divided by one million first:

```html
<p class="kpi-value">{d.shareClass.nav:formatC(2)}</p>
<p class="kpi-value">{d.fund.size:div(1000000):formatC(1)} <small>million</small></p>
```

The KID splits the ongoing costs into management and operating costs, and transaction costs. A tag in the `<title>` element adds them up once with [:set](/documentation/design/computation/store-and-transform.md#store-values-set-absolutepath), and prints nothing:

```html
<title>{d.fund.name}{d.costs.managementAndOperating:add(d.costs.transaction):set(c.ongoing)}</title>
```

The key figures print `{c.ongoing:mul(100):formatN(2)}%`, and the cost example prints the amount on €10,000 invested with `{c.ongoing:mul(d.costs.example):formatC(0)}`.

### 3\. Print the Returns as Percentages

The portfolio system exports the returns and the weights as decimals, like `0.0521`. `:mul(100):formatN(2)` prints `5.21`, and a condition prints a true minus sign before the absolute value of a negative return. Each row of the returns table is one item of a [loop](/documentation/design/template-formats/html.md#loops):

```html
<tr class="{d.performance.trailing[i].label:ifEQ('Fund'):show('is-fund'):elseShow('is-bench')}">
  <td>{d.performance.trailing[i].label}</td>
  <td>{d.performance.trailing[i].ytd:ifLT(0):show('−'):elseShow('')}{d.performance.trailing[i].ytd:abs:mul(100):formatN(2)}</td>
  <td>{d.performance.trailing[i].vol3:mul(100):formatN(2)}</td>
</tr>
<tr style="display:none;"><td>{d.performance.trailing[i+1].label}</td></tr>
```

The calendar years repeat as columns: the `[i]` and `[i+1]` tags sit in two cells of the same row, as in a [horizontal loop](/documentation/design/repetitions/with-arrays.md#horizontal-loops-repeat-columns):

```html
<tr><th>Calendar year (%)</th><th>{d.performance.calendar[i].year}</th><th>{d.performance.calendar[i+1].year}</th></tr>
<tr><td>Fund</td><td>{d.performance.calendar[i].fund:ifLT(0):show('−'):elseShow('')}{d.performance.calendar[i].fund:abs:mul(100):formatN(2)}</td><td>{d.performance.calendar[i+1].fund}</td></tr>
```

Compute the statistics in your portfolio system and send them in the JSON. In this example, the cumulative and annualized returns, the volatility and the tracking error come from the same monthly NAV series that draws the chart.

### 4\. Highlight the Risk Indicator and Keep the SFDR Paragraph

The risk scale has seven cells. An [inline condition](/documentation/design/template-formats/html.md#conditions-inject-css-values-example) adds the `on` class to the cell of the risk class of the KID:

```html
<span class="sri-cell {d.fund.sri:ifEQ(4):show('on'):elseShow('')}">4</span>
```

The sustainability section holds one paragraph for each SFDR article: [:drop(p)](/documentation/design/template-formats/html.md#conditions-drop-keep) removes the two that do not match the article of the fund:

```html
<p>The fund promotes environmental and social characteristics within the meaning of Article 8 of Regulation (EU) 2019/2088 (SFDR). It excludes {d.fund.sfdr.exclusions}, and invests at least {d.fund.sfdr.minSustainableShare:mul(100):formatN(0)}% of its assets in sustainable investments.{d.fund.sfdr.article:ifNE(8):drop(p)}</p>
```

The costs table prints "None" for a cost of zero with the same pattern on two `span` elements.

### 5\. Draw the Charts

The data holds an [ECharts](/documentation/design/advanced-features/charts.md#html-echart-example) configuration for each chart. The performance chart draws the monthly series on a time axis: the fund line is the NAV per share itself, launched at €100, and the benchmark is rebased to 100 at launch. The allocation charts are horizontal bars, with a second category axis on the right that prints the weights of the fund and of the benchmark in two columns. Insert each chart in an `<img>` element with the `:chart` formatter:

```html
<img src="{d.performance.chart:chart}" width="688" height="144" alt="Cumulative performance since launch">
<img src="{d.portfolio.sectorChart:chart}" width="329" height="164" alt="Sector allocation">
```

### 6\. Total the Top 10 Holdings

The top 10 table repeats one row per holding, and its last row adds up the weights with [:aggSum](/documentation/design/computation/aggregation.md#learn-with-aggsum-partitionby):

```html
<tr class="total"><td colspan="2">Top 10 holdings</td><td>{d.portfolio.topHoldings[].weight:aggSum:mul(100):formatN(1)}</td></tr>
```

### 7\. Convert the HTML to PDF

When you generate the factsheet, select **Chromium** as the **Document Converter**, or set `"converter": "C"` and `"convertTo": "pdf"` in the [API request](/documentation/design/template-formats/html.md#convert-html-to-pdf). The PDF matches the layout displayed in Chrome.

_Tip: the result is generated with the options [`lang`](/documentation/developer/http-api/generate-reports.md#multi-language) `en-gb`, and [`currencySource` and `currencyTarget`](/documentation/developer/http-api/generate-reports.md#multi-currency) `EUR`. Send one request per language with a template in that language to publish the factsheet in each country of distribution._

## Related Examples

Check out these similar templates to learn more:

- [Usage-based SaaS invoice](/examples/usage-based-billing-invoice/index.md): HTML template to PDF.
- [CSRD sustainability statement](/examples/csrd-sustainability-report/index.md): HTML template to PDF.
- [HTML annual report](/examples/s-annual-report-html/index.md): HTML template to PDF.

## Related topics

- [Usage-based SaaS invoice](/examples/usage-based-billing-invoice/index.md)
- [Utility invoice with payment slip](/examples/invoice-expert/index.md)
- [Bank statement with page subtotals](/examples/bank-statement-simple/index.md)
- [Checking account statement](/examples/bank-statement-expert/index.md)
- [Monthly management report](/examples/monthly-management-report/index.md)
- [HTML invoice to PDF](/examples/html-report/index.md)
