Attributes
      Back to home
      1. Help Center
      2. Deliver Digital Credentials
      3. Attributes

      A Guide to Image Attributes

      Image attributes are powerful. They can be when used on your certificate designs or email templates.

      What are Image Attributes?

      Image attributes can be used when you need to change images for different certificates whilst still only using a single certificate design. Adding an image attribute will create a container box that gets filled with different image data you upload.

      For example, you may have two different course tutors who teach the same course. The only image in the certificate design that needs to change is the signature. Instead of creating two different designs, you can use image attributes to vary the signature image depending on which recipient had which tutor. 

      Or perhaps you work with multiple partners, and you want to display their respective logos depending on which partner you are issuing for. Image attributes will allow you to do this without creating a design for every single partner. 


      Create an Image Attribute

      1. Navigate to the certificate designer.
      2. Click on the 'Attributes' tab in the lefthand sidebar menu.
      3. At the bottom of the attributes menu, click on 'Manage Attributes.'

        Image Attributes 1
      4. Click the 'Add Custom Attribute' button in the top right-hand corner of the page.
      5. Select 'Image' from the 'Attribute Type' dropdown menu.
      6. Enter the name of your custom attribute. The merge tag name will automatically generate with the name you use for your attribute.
      7. Click 'Add Attribute,' your new custom attribute will appear at the bottom of the attributes list.

        Image Attributes 2

      Adding an Image Attribute to Your Certificate

      1. Navigate to the certificate design you would like to add the image attribute to.
      2. Click the 'Attributes' tab in the lefthand sidebar menu.
      3. Select your custom image attribute from the attribute menu.
      4. If needed, adjust the dimension for the image attribute container, then click 'Add Image Attribute.'
      5. The image attribute will be dropped into the top lefthand corner of the certificate design. You can then drop and drag this to wherever you would like the different images (in this case, signatures) to appear on the certificate. You can also drag the container to resize it if required.

      Image Attributes 3


      Create Image URLs

      You will need to create image URLs for the images you will be using to replace this attribute.

      Don't panic! We have a cheeky workaround to make image URLs easily

      1. Using the 'Elements' tab in the lefthand sidebar menu, upload the images you will be using for the image attribute. The image must be a JPEG or PNG file.
      2. Once the image is placed on the design, right-click on it and select the 'copy image address' option.
      3. Paste the URL address you just copied into your records, identifying which signature this URL address is for so that you do not confuse it with others.

        The URL Address will look something like this:

        https://s3.amazonaws.com/accredible-api-templates/1543364575109.png

        Image Attributes 4

      Using Image Attributes

        1. If you are using the spreadsheet upload method for publishing credentials, create a new column in the spreadsheet you intend to upload. For each recipient, add the relevant image URL needed for their credential.
          Screenshot 2019-10-04 at 15.09.55-1
        2. If you create a credential using the manual method, you can enter the relevant image URL into the field named after the image attribute you created.
        For more information on how to upload data to create credentials, here is our help article: How to Issue a Batch of Credentials
      2. The spreadsheet upload method assigns the column of date with your image URLs to the relevant image attribute.
      3. Continue the credential publishing process as normal.
      4. When the credentials have been created, you will find that your certificate design's empty image attribute container will have been replaced with the relevant image for that credential.

      Image Attributes 5


      Using Image in Email Templates

      For a great example of using image attributes in your email templates, check out our article on the subject: Managing Attributes in Emails.


      Has this article helped you? Let us know!

      If you would like to tell us about any improvements you feel could be made to this page, you can email us at support@accredible.com.