> For the complete documentation index, see [llms.txt](https://docs.wiclax.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wiclax.com/en/other-features/certificates.md).

# Certificates

Certificates - or diploma - are the documents athletes can print out to proudly testify about their participation to a competition.

Wiclax allows to design such certificates, to print them locally (though it's rarely done nowadays) and to make them available for the athletes in a digital fashion, on the web.

## Design

The design tool can be found here:

<figure><img src="/files/UEhTA58YeRBlb3o2bT53" alt="" width="256"><figcaption></figcaption></figure>

It allows you to work on certificate templates, which are handled as separate files of extension `.mdp`.

Designing consists in adding some graphics elements on the page, in a way you should find familiar like moving them with the mouse on the graphic preview.

<figure><img src="/files/PEuowh3Y39ZpjTGzP6Vj" alt="" width="563"><figcaption><p>The certificate design tool</p></figcaption></figure>

Elements are basically either graphics or texts.

Text contents can be filled with variables, like for example the athlete name or its ranking in the race.

{% hint style="info" %}
Using the `Preview` button from the ribbon, you can get the variable texts filled with some final sample data. Helping figuring out how it will render in the end.
{% endhint %}

{% hint style="info" %}
**Text fonts** customization will best work if you pick up some Google fonts as they get proposed. The main reason for it is that they can easily be made accessible from the Web compared to any local font.

To help with getting an accurate preview on the designer, you may have to install locally a selected Google font, using for that the button located right aside the font selector.
{% endhint %}

## Printing

The first thing to do if you want to locally print certificates is to bind the template of your choice to the event, clicking on the `Template for the event` button.

The printing can then be launched from the design window, or from the participant/result grid context menu. In the opening dialog you will be able to specify the scope of participants for the batch: based on a bib range, a ranking range or on the current selection in the grid.

## On the web

More often you will make certificates available on the Web so it's up to participants themselves to download and eventually print them.

Wiclax is doing that through the G-Live app. If available a preview of the certificate will show up in the athlete summary form as part of his/her result information. With the condition that he/she's ranked as a finisher.

{% hint style="info" %}
The final rendering of a certificate on the web is done through a PDF document generation, which is most suitable for printing and saving.
{% endhint %}

Setting online certificates is done through the Web publication window:

<figure><img src="/files/peIwltI8wmFV5CDzCXJ8" alt="" width="563"><figcaption></figcaption></figure>

Here you can upload any certificate template to bind to your event. It can be either a single one to use for all races in the event, or a per race selection if you have different graphics requirements for example.

## Diploma

In the `Attribution rules` pane of the certificate designer, you can setup a Gold/Silver/Bronze system of rewards.

Awarding will be calculated based on the rules you provide, possibly minimum race times to achieve expressed either as absolute values or as percentage of the race leader performance. Those settings can be provided for each race and each participant category if necessary.

Once activated, the Gold/Silver/Bronze award value will become available as a column on the result grid, as well as a printable variable value for a certificate design.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.wiclax.com/en/other-features/certificates.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
