ClearCompany Learning: Using the Certificate Builder - Guide

Follow

The Certificate Builder allows you to create and customize branded, professional certificates that auto-fill with relevant data. This article explains how the editor works, including grid layout, text tools, placeholders, and best practices.

In this article:

Understanding the Grid System
Certificate Layout Tools
Text Formatting & Placeholders
Creating Certificate Templates: Best Practices
Frequently Asked Questions
Additional Resources

Understanding the Grid System

Certificate layouts are built using rows and columns. Each row can contain one or more columns that hold text, images, or placeholders.

Row with three columns example 


Accessing the Certificate Builder

You access the Certificate Builder from an existing certificate template. Use this section to confirm you are in the correct place before editing layout or formatting.

Follow these steps to open the Certificate Builder:

  1. From the admin dashboard, click Administration.
  2. Click Settings, then select Certificate Templates
    Certificate Templates navigation screen
  3. In the Certificate Templates list, select an existing template or click +Create Template to create a new one. 
    Create Template button
  4. If creating a new template, complete the required fields and click Save.
  5. Click Go to Editor to open the Certificate Builder. 
    Go to Editor button

Once the editor loads, you can begin building or updating the certificate layout using rows, columns, text blocks, images, and placeholders.


Certificate Layout Tools

There are a number of ways to build out and customize your template. Using the appropriate menus, you can position text, images, and placeholders exactly where and how they should appear on the final certificate.

Background Image
alt-text

Click the Background Image button on the right side of the builder to upload the image for this template. The background is used for borders, frames, and watermark-style designs.

It sits behind all other content on the certificate and is separate from the logo controlled by your Theme settings (if using one of the default templates as a base).

File requirements:

  • Valid file types: jpg, gif, png, bmp
  • Optimal dimensions: 1485px x 1100px
  • Maximum width: 1485px
Getting Started
alt-text

When you first open a certificate template you’ll see a single empty row. This is your starting point for building the layout of the certificate.

At the top of the row, the row toolbar appears. These controls help you begin structuring the certificate:

  1. +: Start here. Click to select from one of two available base templates.
  2. Undo / Redo: Quickly reverse or reapply your last edits.
  3. <>: Open HTML mode for advanced users.
  4. Wrench: Access row-level settings and options.
alt-text

You can create your own template from scratch. Click the EMPTY placeholder. Selecting this opens the element menu where you can add text blocks, images, and other elements.

Once you select your base template or add your first element, the layout tools and column controls appear, allowing you to continue building and arranging the certificate structure.

Column Controls
alt-text

When a row contains content and you click inside its boundary (but not directly on a text or image element), the column controls appear on the left side of the row.

  1. +: Add a new column inside the row.
  2. : Open a "More" menu, including moving the column.
  3. Trash can: Delete the selected column and its contents.
Top Toolbar
alt-text

The top toolbar appears above the row and provides editing options that affect the active element or the row as a whole.

  1. +: Add a new element inside the active column.
  2. Alignment icons: Adjust text alignment for the active element.
  3. Undo / Redo: Reverse or redo your most recent actions.
  4. <>: Switch to HTML mode for advanced editing.
  5. Wrench: Access additional row-level preferences.
Grid Controls
alt-text

Grid controls appear on the right side of the row and let you manage the row’s position and overall layout.

  1. Move icon: Drag the entire row to a new location.
  2. Grid icon: Open the grid editor to restructure rows and columns.
  3. Trash can: Delete the entire row and all content within it.

 


Text Formatting & Placeholders

This section covers how to style text and insert placeholders. Use these tools to format headings, adjust spacing, and automatically pull learner or object data into the certificate.

Text Editing Toolbar
alt-text

When you click into a text area, the text editing toolbar appears at the top of the builder. These controls let you insert placeholders and format the selected text.

  1. +: Add a template.
  2. <...>: Opens a list of placeholders. See below for more details.
  3. B / i / U: Apply bold, italics, or underline to the selected text.
  4. a: Open the font picker and choose from the available certificate fonts.
  5. Color icon: Adjust text color and background color. You can use the sliders or enter exact values to match your brand palette.
  6. Alignment icons: Align text left, center, right, or justified.
  7. Slider icon: Open font adjustments for size, weight, line spacing, and letter spacing.
  8. Link icon: Turn the selected text into a hyperlink.
  9. Undo / Redo: Reverse or reapply your last changes.
  10. <> (HTML): Switch to HTML mode for advanced editing of the text block.
  11. … (More): Opens additional options such as emoji/icons, SVG, image insertion, extra text styles (subscript, superscript, strikethrough), heading levels, and other advanced settings.
Available Placeholders

Placeholders automatically populate with real learner, object, or certification data when the certificate is generated.

  • [CERTIFICATION_PLAN_DESCRIPTION]Description of the certification plan.
  • [CERTIFICATION_PLAN_NAME]Name of the certification plan.
  • [CLEARCO_ID]User’s ClearCompany system ID.
  • [COMMENTS]Comments on the completion record.
  • [COMPLETION_DATE]Date the learner completed the item.
  • [COMPLETION_TIME]Time of completion.
  • [COURE_CREDITS_]Credits assigned (if applicable).
  • [CURRENT_DATE]Date the certificate is generated.
  • [EVALUATION_MANAGER_FULL_NAME]Evaluation manager’s full name.
  • [FACILITY]Learner’s facility (if used by your org).
  • [FACULTY]Learner’s faculty/department.
  • [FIRST_NAME]Learner’s first name.
  • [FULL_NAME]Learner’s full name.
  • [JOB_TITLE]Learner’s job title.
  • [LAST_NAME]Learner’s last name.
  • [LOCATION_]Learner’s location field.
  • [OBJECT_AUTHOR]Author of the object.
  • [OBJECT_LENGTH]Length/duration of the object.
  • [OBJECT_NAME]Object or course name.
  • [RECORD_ID]Completion record ID.
  • [SCORE]Score the learner received.
  • [THEME_LOGO_IMAGE]Logo defined in your active theme.
Text Submenu
alt-text

When selecting a text element, a small text submenu appears at the lower right of the row. This submenu provides quick actions:

  1. +: Insert a new element directly beneath the text block.
  2. : Open the full More menu for text block actions.
  3. Trash icon: Delete the selected text element.
alt-text

Clicking opens the More menu, which includes the following actions:

  1. Move Up: Shift the text block one position higher.
  2. Move Down: Shift the text block one position lower.
  3. Duplicate: Create an identical copy of the text block.
  4. Settings: Open the full settings panel for advanced styling.
alt-text

Selecting Settings opens the full text-block configuration panel. This menu contains multiple tabs:

  1. General: Background color, gradients, background image, grayscale effect, and visibility controls for different screen sizes.
  2. Box: Padding, borders, corner radius, and basic structural adjustments for the text container.
  3. Spacing: Control margins above or below the text. This is especially helpful for fine-tuning alignment when line breaks aren’t enough.
  4. Text: Font size, weight, letter spacing, line height, text color, and other typography refinements.
  5. More (⋯): Additional styling or metadata options depending on the element type.

Creating Certificate Templates: Best Practices

Best Practices for Certificate Template Creation

Follow these best practices to create certificate templates that look professional, align properly, and work reliably across different layouts and screen sizes.

  1. Use Preview Changes frequently to check layout and spacing.
  2. Optimal background size: 1485 × 1100.
  3. Logos on the default base template and logo placeholder come from the Theme that is assigned to the learner: Admin Dashboard → Settings → Themes.
  4. Keep text centered for formal certificates unless your branding dictates otherwise.

Creating Certificate Templates FAQ

How do I change the logo on my certificate?

The logo in the default base template and placeholder is set by the Theme that is assigned to the learner, not the certificate editor. Go to Admin Dashboard → Settings → Themes and upload your logo there. Once updated, the new logo automatically appears anywhere you use the [THEME_LOGO_IMAGE] placeholder.

What size should my background image be?

Background images must meet the editor’s requirements:

  • Accepted file types: jpg, gif, png, bmp
  • Minimum width/height ratio: 1.35 (e.g., 1485×1100, 1080×800, 810×600)
  • Maximum width: 1485px

To upload a new background, click Background Image in the right-hand menu of the editor.

My text won’t align where I want. How do I fix it?

If alignment seems off, there are two ways to correct spacing:

  • Add line breaks: Place your cursor and press Enter to increase vertical spacing.
  • Use the “More” menu: Click the icon on the text submenu, then click Settings, followed by Spacing to adjust margins (top/bottom) to fine-tune the layout.

You can also use the alignment icons on the text toolbar to center or left/right align the selected text.

Why isn’t my placeholder showing real data?

Placeholders such as [FULL_NAME] or [COMPLETION_DATE] only populate when a certificate is generated for a learner. In the editor, they always appear as bracketed text.

If a placeholder does not populate on an actual certificate, verify the corresponding field exists in the learner’s record.

Can I resize or move elements inside the certificate?

Yes. Click a row or column to reveal structural controls, or click directly on an element to access its formatting tools:

  • Move: Drag rows using the right-side move icon.
  • Resize: Adjust column widths or add/remove columns.
  • Spacing: Add margins or padding from the text “More” menu.

Rows, columns, and text elements all expose different toolbars depending on where you click.


Additional Resources

ClearCompany Learning: Certificate Templates
ClearCompany Learning: Certification Plans vs Assignments — Best Practices
ClearCompany Learning: Themes
ClearCompany Learning: Custom HTML Page Editor

0 out of 0 found this helpful

Comments

0 comments

Please sign in to leave a comment.