{"id":20093,"date":"2026-11-10T18:55:00","date_gmt":"2026-11-10T18:55:00","guid":{"rendered":"https:\/\/sertifier.com\/blog\/?p=20093"},"modified":"2026-11-10T18:55:00","modified_gmt":"2026-11-10T18:55:00","slug":"custom-certificate-attributes","status":"publish","type":"post","link":"https:\/\/sertifier.com\/blog\/custom-certificate-attributes\/","title":{"rendered":"Custom certificate attributes: define the field before importing values"},"content":{"rendered":"<p>A field called \u201cCode\u201d can mean a course code, a cohort label or a credential identifier. If the team importing recipients and the team designing certificates interpret it differently, a successful upload can still produce the wrong document.<\/p>\n<p>Before creating a custom certificate attribute, define what it means, where its value comes from and where a recipient will see it. Then test a small fictional record from the source file through to the finished credential.<\/p>\n<h2>What is a custom certificate attribute?<\/h2>\n<p>An attribute supplies a value to a credential. Sertifier&#8217;s <a href=\"https:\/\/help.sertifier.com\/what-are-attributes-and-how-to-use-them\">attribute overview<\/a> distinguishes attributes from the surrounding certificate design. Its <a href=\"https:\/\/help.sertifier.com\/create-and-use-custom-attributes\">custom attribute guide<\/a> documents creating named fields with types such as text, date and number, and matching them during recipient upload.<\/p>\n<p>The field label is an administrative choice; it does not establish that the supplied value is correct. Treat the definition and the value as separate review tasks.<\/p>\n<h2>Write a field definition before opening the designer<\/h2>\n<p>Use a short record for each proposed field. This is a suggested team workflow, not a claim that Sertifier automatically enforces these rules.<\/p>\n<ul>\n<li><strong>Meaning:<\/strong> What exact fact does this field represent?<\/li>\n<li><strong>Source:<\/strong> Which approved record supplies the value?<\/li>\n<li><strong>Owner:<\/strong> Who resolves an unclear or conflicting value?<\/li>\n<li><strong>Type:<\/strong> Is this text, a date or a quantity?<\/li>\n<li><strong>Empty value:<\/strong> Is omission acceptable, or should issuance stop for review?<\/li>\n<li><strong>Destination:<\/strong> Does it belong on the certificate, in its description, in an email or nowhere public?<\/li>\n<li><strong>Change scope:<\/strong> Is the definition for new awards only, or is a correction to existing records intended?<\/li>\n<\/ul>\n<p>Prefer a label such as \u201cWorkshop location\u201d to \u201cLocation\u201d when the program also records a learner&#8217;s address or an employer&#8217;s office. A field should not silently change meaning between campaigns that reuse it.<\/p>\n<h2>Work through a fictional example<\/h2>\n<p>Suppose a training team is preparing a fictional Sample A certificate for a laboratory workshop. Its approved source record has these values:<\/p>\n<figure class=\"wp-block-table\">\n<table>\n<thead>\n<tr>\n<th>Field<\/th>\n<th>Meaning<\/th>\n<th>Example value<\/th>\n<th>Review decision<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Workshop code<\/td>\n<td>Identifier assigned to the workshop<\/td>\n<td>LAB-07<\/td>\n<td>Keep the approved characters as text<\/td>\n<\/tr>\n<tr>\n<td>Completion date<\/td>\n<td>Date the completion requirement was met<\/td>\n<td>10 November 2026<\/td>\n<td>Confirm the meaning before choosing the displayed date format<\/td>\n<\/tr>\n<tr>\n<td>Completed sessions<\/td>\n<td>Count of sessions recorded as completed<\/td>\n<td>8<\/td>\n<td>Confirm what is counted and who approved the count<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n<p>These are invented test values, not customer data or recommended thresholds. The workshop code is not a credential ID. The completion date is not automatically the issue date. The session count does not establish a qualification, credit entitlement or level of competence.<\/p>\n<p>Write the intended certificate sentence before mapping the fields: \u201cCompleted the LAB-07 workshop on 10 November 2026, with 8 sessions recorded as completed.\u201d If the program cannot support that sentence, revise the claim before adjusting the layout.<\/p>\n<p>For distinctions between completion, issue and delivery dates, use the separate <a href=\"https:\/\/sertifier.com\/blog\/course-certificate-dates\/\">course certificate dates guide<\/a>.<\/p>\n<h2>Choose types for meaning, then test the accepted format<\/h2>\n<p>A code that contains digits can still be an identifier rather than a quantity. Preserve meaningful characters, including any leading zero, in the approved source and inspect the final result. Do not infer how an import will treat a value from how a spreadsheet displays it.<\/p>\n<p>For dates, record the intended day unambiguously in your review notes. Use the input format supported by the current import interface, then compare the rendered date with the source. A visually tidy date is not evidence that a day and month were interpreted correctly.<\/p>\n<p>For quantities, define the unit separately. \u201c8\u201d is unclear if one reader assumes hours and another assumes sessions. If the value can be unknown, do not replace a blank with zero merely to complete the file. Resolve the exception with the program owner.<\/p>\n<h2>Map the source column to the intended attribute<\/h2>\n<p>Sertifier&#8217;s <a href=\"https:\/\/help.sertifier.com\/create-and-use-custom-attributes\">custom attribute instructions<\/a> describe creating attributes in the designer, Credential Details or Email Templates, then matching uploaded recipient data to the field. Review each destination actually used in your campaign; do not assume that placing an attribute on a certificate also places it in the email.<\/p>\n<p>Use a fictional row whose values are visibly different from one another. A workshop code, a clear date and a session count make a swapped mapping easier to identify than several identical placeholder values. Check the attribute name and the resulting sentence, not just whether every column has a selection.<\/p>\n<p>If the upload will change existing recipients, review <a href=\"https:\/\/sertifier.com\/blog\/recipient-import-change-scope\/\">recipient import change scope<\/a> before proceeding. Correct mapping and correct update scope are separate decisions.<\/p>\n<h2>Inspect the finished record, not only the upload message<\/h2>\n<p>For each field, compare the approved source, the selected mapping and the visible output. Record whether the meaning and characters survived. Inspect only the surfaces your campaign actually uses, including the credential description and message when those contain the field.<\/p>\n<p>Keep missing-value behavior explicit. If an optional workshop location is empty, review whether the output leaves a dangling label or an incomplete sentence. If the completion date is required by your program, hold the affected record for review instead of supplying today&#8217;s date.<\/p>\n<p>Use the <a href=\"https:\/\/sertifier.com\/blog\/credential-template-data-fit-testing\/\">certificate template testing checklist<\/a> for wrapping, clipping and long values. That is a separate check from whether the field contains the right fact.<\/p>\n<h2>Keep a reusable mapping note<\/h2>\n<p>Save the approved field definitions with the source-file version and the tested design revision in your team&#8217;s controlled working area. Record the person responsible for exceptions and the date of the review. Keep recipient files and private operational identifiers out of public examples.<\/p>\n<p>When a field&#8217;s meaning changes, revisit every destination that uses it. Do not assume renaming a label corrects historical values. Decide whether the change belongs in a new campaign or requires a separately authorized correction.<\/p>\n<h2>Frequently asked questions<\/h2>\n<h3>Should every spreadsheet column become a certificate attribute?<\/h3>\n<p>No. Include a field only when it supports the approved credential or message. An internal processing note can remain in the team&#8217;s working record without appearing on a recipient-facing document.<\/p>\n<h3>Can I reuse an existing attribute?<\/h3>\n<p>First check that its meaning, expected values and intended destinations match the new campaign. A familiar label alone is not sufficient. Test the reused field before processing real recipients.<\/p>\n<h3>Does a successful import prove the certificate is correct?<\/h3>\n<p>It does not establish that the selected field represents the intended fact or that the rendered text is complete. Compare a test credential with the approved source and record exceptions before expanding the batch.<\/p>\n<h2>Set up your first mapped example<\/h2>\n<div class=\"sertifier-conversion-cta\">\n<p>Already using Sertifier? Follow the <a href=\"https:\/\/help.sertifier.com\/create-and-use-custom-attributes\">custom attribute guide<\/a>, then run a fictional example through the destinations you plan to use. New to the platform? <a href=\"https:\/\/app.sertifier.com\/signup\">Create a Sertifier account<\/a> and prepare a certificate whose fields have clear definitions before adding a real cohort.<\/p>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>Define custom certificate attributes, map approved source values and check text, dates and numbers before issuing a cohort.<\/p>\n","protected":false},"author":3,"featured_media":20094,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"rank_math_title":"Custom certificate attributes in Sertifier","rank_math_description":"Define custom certificate attributes, map approved source values and check text, dates and numbers before issuing a cohort.","rank_math_focus_keyword":"custom certificate attributes","rank_math_canonical_url":"","footnotes":""},"categories":[939],"tags":[],"class_list":["post-20093","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-digital-credentials"],"_links":{"self":[{"href":"https:\/\/sertifier.com\/blog\/wp-json\/wp\/v2\/posts\/20093","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/sertifier.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/sertifier.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/sertifier.com\/blog\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/sertifier.com\/blog\/wp-json\/wp\/v2\/comments?post=20093"}],"version-history":[{"count":1,"href":"https:\/\/sertifier.com\/blog\/wp-json\/wp\/v2\/posts\/20093\/revisions"}],"predecessor-version":[{"id":20095,"href":"https:\/\/sertifier.com\/blog\/wp-json\/wp\/v2\/posts\/20093\/revisions\/20095"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/sertifier.com\/blog\/wp-json\/wp\/v2\/media\/20094"}],"wp:attachment":[{"href":"https:\/\/sertifier.com\/blog\/wp-json\/wp\/v2\/media?parent=20093"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/sertifier.com\/blog\/wp-json\/wp\/v2\/categories?post=20093"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/sertifier.com\/blog\/wp-json\/wp\/v2\/tags?post=20093"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}