> For the complete documentation index, see [llms.txt](https://docs.riskbase.uk/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.riskbase.uk/creating-+-modifying-assessment-templates/customising-pdf-layout.md).

# Customising .PDF layout

## **What is the PDF layout?**

Every assessment completed in RiskBase generates a PDF report.

The overall layout and structure are built into the system to ensure consistent, professional reporting.

However, users can still **customise selected elements of the PDF layout.**

For example, to edit a template's introduction text, or to select whether to include a contents page or not.

## **Pre-requisites**

* Download the RiskBase app from the Apple Store or Google Play Store, or search [app.riskbase.uk](https://app.riskbase.uk) in a web browser.
* Ensure an account has been set up and sign-in.
* Ensure the account has been given access to view and modify assessment templates.

## **Choose a template**

{% stepper %}
{% step %}

#### Open the app and go to 'Settings'.

{% endstep %}

{% step %}

#### Click 'Assessment Templates'.

<div data-with-frame="true"><figure><img src="/files/KGjeANHAsuc4vqE7obAM" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

#### Click on a template

{% endstep %}

{% step %}

#### Click the 'PDF' button next to the 'General' button.

<div data-with-frame="true"><figure><img src="/files/IhnenBdoasEHGmwC4tzy" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

## **Page settings**

{% stepper %}
{% step %}

#### Use the tick boxes to select whether to include a Contents page, Summary / Certificate page, or a Photo Gallery.

<figure><img src="/files/VQXFamI5LF7P5V9BiDxX" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

## **Signatories**

1. Use the tick box to select whether to have signatory information included in the report.
2. Edit the tab that has 'Signatories' written in it to change the title.
3. Add introductory text for this section in the 'Signatories Introduction' tab.

<figure><img src="/files/Fc3mXyPOOckLt8IwV3JH" alt=""><figcaption></figcaption></figure>

## **Action Plan**

1. Click the tab under 'Action Plan' to select how [actions](/glossary/action.md) will be ordered on the report (e.g., by due date or severity).
2. Add introductory text to the action plan in the 'Action Plan Introduction...' tab.

<figure><img src="/files/4JqzBLQw8VBPjivHa0RG" alt=""><figcaption></figcaption></figure>

## **Actions and Controls**

1. Click the tab under 'Actions and Controls' to select the order and appearance of actions and [controls](/glossary/control.md) on the PDF report (e.g., 'Actions then Controls', 'Show Actions and Hide Controls).
2. Use the tick boxes to further customise the way that actions and controls are presented on the PDF.

<figure><img src="/files/uGMDbe2aTCwknZOkvxM8" alt=""><figcaption></figcaption></figure>

## **Checklists**

1. Use the tick box to select whether to show or hide 'Dash' [checklist items](/glossary/checklist-item.md) on the PDF report.

<figure><img src="/files/gp0xYMIYEZ4Sm8O0svyP" alt=""><figcaption></figcaption></figure>

'Dash' checklist items are statements in a checklist which an assessor has marked with a dash symbol, to indicate that this information is **not applicable** in that assessment.

<figure><img src="/files/xqDTM4uMTiJgrDj3CDD9" alt=""><figcaption></figcaption></figure>

If left unticked, any checklist item marked with a 'dash' will not appear on the report at all.

## **Approved Label**

Some organisations may use different wording to 'Approved' on their reports (e.g., 'Validated).

1. To change the wording from 'Approved' to another term, enter this into the text box under 'Approved Label'.

<figure><img src="/files/y5ibdZgdoSiwTulCr53g" alt=""><figcaption></figcaption></figure>

## **PDF Introduction**

Standard RiskBase templates, which are provided to each new customer, all come with pre-written introductions set to BS guidelines (e.g., BS 9792 for fire risk assessments).

They are written using basic markdown:

| Markdown symbol |     Text format    |
| :-------------: | :----------------: |
|        #        |    Main heading    |
|        ##       |     Sub-heading    |
|       ###       | Second sub-heading |
|        \*       |    Bullet point    |
|   \*\*text\*\*  |     Makes bold     |

They also include sections of code which dynamically pull in information such as the organisation or property name (see below under '# Introduction').

<div data-with-frame="true"><figure><img src="/files/DB6VHxrXfsg3x9JxDDtm" alt=""><figcaption></figcaption></figure></div>

There are also codes to pull in tables about the risk scoring methodology, severities and timescales used in the assessment (e.g., {TABLE:RISKRATING:MATRIX} ).

<div data-with-frame="true"><figure><img src="/files/RpGEuEp6FR5zvgG6xqby" alt=""><figcaption></figcaption></figure></div>

For example, {TABLE:RISKRATING:MATRIX} would pull the risk rating matrix onto the PDF report.

<div data-with-frame="true"><figure><img src="/files/vDWCUQqOg68ImgGCCzwd" alt=""><figcaption></figcaption></figure></div>

1. To edit or add to the introduction, type directly in the text box under 'PDF Introduction' (e.g., to add disclaimers).
2. Alternatively, users can copy and paste the standard introductory text into in the 'PDF Introduction' section of a new blank template, or write a new introduction entirely.

{% hint style="info" %}
Make sure that any new text is written using markdown symbols (see above).

If starting from scratch, make sure to copy any codes (see above) into the introduction to pull through these tables.
{% endhint %}

<figure><img src="/files/RHQFEd2TAepsNE5EXwRO" alt=""><figcaption></figcaption></figure>

## **PDF Appendix**

1. Add text to appear as an appendix at the end of the report by typing into the box under 'PDF Appendix'.

<figure><img src="/files/hqZXGWILZKrhBpFe9lnq" alt=""><figcaption></figcaption></figure>

## **PDF Colours**

The colour of the headings on the PDF report can be changed.

1. Provide a HEX codes next to a header type to change the colour on the PDF.

<figure><img src="/files/OLQS9yEE8NIA7LZPh8CO" alt=""><figcaption></figcaption></figure>
