# How to create a certificate

You can create and configure any certificates to your liking, without in-depth technical knowledge.

{% hint style="success" %}
Issued certificates can be recreated and modified if necessary.
{% endhint %}

The certificate builder from MaviBot provides the ability to create a certificate with or without a link to your course.

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

Customize your certificate, turn your fantasy into reality, use any images that you like! You can also insert a variety of texts and format them as you see it.

## Let's start!

To create a certificate, go to the “Courses” tab, where two tabs will be located on top. You need to go to the “Certificate builder”.

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

If you don't have any certificates created yet, then the button is displayed in the center of the workspace; if you have ready-made products, then it is on the right side of the screen.

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

After clicking on the "Create" button, you will go to the basic settings of the certificate.

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

### Main certificate settings

In the main settings of the certificate, the format and the binding to the course are configured. If you already have a course, the image for the certificate is selected.

**Certificate name** is a text field for the name of your certificate.

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

**The certificate format** allows you to select the form of your certificate: 1:1 (square), 16:9 (rectangular) or 4:3 (portrait).

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

{% hint style="warning" %}

## Please note

The uploaded image must match the selected format.
{% endhint %}

**Then you can select the course** and the plan to which your certificate will be linked.

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

If you don't have any courses, you can skip this step.

{% hint style="info" %}
The certificate settings do not require you to link to a specific course or pricing plan. This setup ensures that a student will receive the certificate after successfully finishing any course from your catalog, on any available plan.
{% endhint %}

If you want to issue a personalized image as a certificate, then use the "Custom image" checkbox without reference to the course:

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

{% hint style="info" %}
How to create personalized images and display them through a bot is described in the article "[Personalized images](/how-to-do.../personalized-images.md)".
{% endhint %}

In the “**Upload certificate**” field, insert the image that will be the background of your certificate.

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

You can download the image from your device or add a link to it from the file storage.

To add a certificate from the file storage, upload an image in the appropriate section.

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

Then copy the link to it:

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

And paste the link into the URL field in the certificate builder:

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

Then click on the “**Save**” button:

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

There will be the line “Configure input fields”. Click on it to continue configuring the certificate:

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

### Input field settings

{% hint style="success" %}

## Please note

The certificate will display the data that the student entered in his personal account. Therefore, it is important to notify your students that the data must be entered correctly: a full name and a photo of the student.
{% endhint %}

Configure the default text in these input fields. Their values will be auto-filled at the moment of certificate issuance.

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

**Name**

This field defines the **recipient's name**. When a student finishes the course, their name will be auto-inserted into this field on the certificate.

You have full control over its appearance: choose the font, adjust the weight and size, select a color, and set its exact positioning.

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

You can edit text elements directly on the certificate preview:

* **To move:** Hover over the text until the cursor changes to a hand icon. Then, click and drag the element to its new position.
* **To resize:** Hover over the lower-right corner of the text box until the cursor changes to a resize arrow. Click and drag to adjust the size.\
  All changes are instantly reflected in the settings panel.

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

**Date**

Displays the certificate issue date, which is automatically set to the student's course completion date.

> **Logic:** For courses with homework, the date reflects the submission of the last assignment. Otherwise, it's the date of the final lesson.

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

**Avatar**

Displays the student's profile picture. You can customize it by changing its position and selecting a shape (e.g., circle, square, rounded square).

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

{% hint style="info" %}

## Please note

* If you do not want an avatar to be displayed on your certificate, do not fill in the fields.
* If you choose to display an avatar on the certificate, but the photo is not uploaded to the student's personal account, an empty avatar will be displayed on the certificate.
  {% endhint %}

**The serial number of a certificate** consists of a series and a number. You can enter the series yourself and edit it in the same way as the name or date. The number is generated automatically when the certificate is issued.

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

You can also add any text.

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

To do this, click on “Add text”, then enter the required text and edit it to your liking. To increase or decrease the size of your text, you need to enter a numeric value in the “Size” field.

{% hint style="success" %}
If you want the text to be in the same style, you can copy the size and color of the text, and select the appropriate font and thickness.
{% endhint %}

To avoid losing the entire setup progress, click on the “Save” button.

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

After setting up all the data, you can download a preview to see how your students' certificate will look like:

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

{% hint style="success" %}
All created certificates are displayed in the "Certificate builder". You can always replace them or change the settings.
{% endhint %}

Your certificate is now active! It will be **issued automatically** to students who successfully complete the course criteria (all lessons and any required homework) and will be available for download in their personal accounts.

## Issuing certificates via a chatbot

To configure certificate issuance via your chatbot, follow these steps:

1. Navigate to the bot workflow that will handle the certificate delivery.
2. Add a new block to this workflow.
3. Within the block, select the **Calculator** function and configure it for certificate operations.

**get\_certificate(course\_id, name\_on\_cert, avatar, date, tariff\_id, texts)**

{% hint style="warning" %}

## Please note

Using this function within your bot consumes resources equivalent to sending **10 standard messages**.
{% endhint %}

{% hint style="danger" %}

## &#x20;Attention

Certificate configuration in the course settings must be completed prior to using this function.
{% endhint %}

<table><thead><tr><th width="231">Function parameters</th><th>Parameter description</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> course_id</strong></td><td>course ID</td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> name_on_cert</strong></td><td><p>a name on the certificate</p><p>(you can ask or take it directly from a client's card)</p></td></tr><tr><td><strong>avatar</strong></td><td><p>optional parameter, 1 - if you need to transmit the client's avatar, 0 - if not</p><p><em>(0 is the default value, do not forget to configure the avatar display in the course if you want to transmit it)</em></p></td></tr><tr><td><strong>date</strong></td><td><p>optional parameter, date in any format</p><p><em>(default will be the current one)</em></p></td></tr><tr><td><strong>tariff_id</strong></td><td><p>an optional parameter is needed if you want to issue a certificate configured for a plan</p><p><em><strong>(</strong><mark style="color:red;"><strong>!</strong></mark><strong> </strong><strong>the plan must be configured beforehand)</strong></em></p></td></tr><tr><td><strong>texts</strong></td><td><p>is an optional parameter to pass an array of texts to.</p><p>(if you transmit <strong>more texts</strong> than you have set up, then <strong>simply discard the extra ones</strong>; if you transmit <strong>fewer</strong>, it will <strong>display the ones you have transmitted</strong>)</p></td></tr></tbody></table>

{% hint style="danger" %}
! <mark style="color:red;">**Errors in transmitting parameters:**</mark>

* If the course\_id parameter is passed incorrectly, the function returns <mark style="color:red;">**the error wrong course\_id.**</mark>
* If the tariff\_id parameter is passed incorrectly, it returns <mark style="color:red;">**the error wrong tariff\_id.**</mark>
  {% endhint %}

{% hint style="success" %}
Once set up, the bot will issue the certificate to the student via a chat message with an access link.
{% endhint %}

{% hint style="info" %}
To learn how to create and issue personalized images using the certificate builder, please refer to the article "[Personalized images](/how-to-do.../personalized-images.md)".
{% endhint %}


---

# Agent Instructions: 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:

```
GET https://docs.mavibot.ai/lms/certificate/builder.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.