Support Knowledge Base Training 

Uploading Assets to the DAM in AEM

Always start the suport article creation process by uploading all supporting assets to the Digital Asset Manager aka DAM. These assets include Images and PDFs. 

Image Best Practices:

1.   Avoid text in images – it can be difficult to read for users who rely on screen readers or have visual impairments. It also doesn’t scale well for responsive designs, causing issues on various devices.

2.   When adding text in images – If text must be included for the image design purposes like logos, infographics or charts, it’s best to describe the text separately in the images alt text to remain compliant with Accessibility Web Standards. When loading your image in AEM use the Description field in the image properties to add alt text. Alt text should be brief yet clear enough to describe the purpose of the image or its content. Think of it as a summary.

• Avoid Using “Image of…” or “Picture of…”: Screen readers already identify that.
• Good example: for a chart image: “Bar chart comparing sales over the past 5 years.”

3.  Image File Name – all lowercase letters, use hyphen to replace spaces & no special characters.

Social & Main Image Specs:

Size: 617 x 347px

File size: >200KB

Format: JPG or PNG

Location: /content/dam/mhe/blog/[current-year]/image

Social Share Image: 

This is an image that displays when the blog is shared on social media and as the thumbnail when post is referenced on mheducation.com If no image is submitted, a default placeholder McGraw Hill logo will be used.

Main Image:

This will always appear full width across the post directly above the Body copy. 

Author Bio Image:

Design a square image (Aspect Ratio: 1:1 Square; 400x400 px; .jpg or .png or .webp) with the subject centered and enough margin around the edges so it looks good when styled as a circle using border-radius: 50%

File name format example: [first-name]-[last-name].jpg

• all lowercase letters
• hyphen between first and last name (no spaces or underscores)
• no special characters (e.g., no accents, apostrophes, or punctuation)

Image file name format examples:

jane-smith.jpg

john-oconnor.png

PDF Best Practices:

File name format

• all lowercase letters
• hyphen between words (no spaces or underscores)
• no special characters (e.g., no accents, apostrophes, or punctuation)

Optimize File Size for Web

Compress PDFs: Reduce file size by compressing images and optimizing the PDF content without sacrificing quality, to ensure faster loading times on the web.

Embed Fonts Efficiently: If embedding fonts, only embed the characters used in the document to save space.

Remove Unnecessary Elements: Eliminate unused objects, metadata, or redundant images that can increase the file size unnecessarily.

Test PDF for Accessibility: Adobe Acrobat Accessibility Checker: Use the built-in accessibility checker in Adobe Acrobat Pro to identify issues and fix them before publishing.