Using callouts
Use callouts to draw the user's attention to a particular part of a graphic or to provide additional information. Each callout is composed of three parts: the rectangle that you use to select a part of the screenshot, the connecting line, and the callout text with an explanation.
Apply the following general settings for callouts:
Use a blank fill (
#FFFFFF
).Set Opacity to 100%.
Set Padding to 0
Do not use shading.
Use 2pt yellow callout lines (
R254
,G181
,B58
in RGB or#FEB53A
in HEX).Note: For accessibility, do not refer only to the callout color. Instead, refer to the section or control name on the screen. Use straight, continuous lines only.
Note: Do not use background shading or shadows on lines, heavy lines, or start/end shapes (arrow heads). Use parallel pointer lines, preferably horizontal or vertical.
To highlight a part of a graphic, use yellow 2pt rectangles or ellipses.
Do not use bubbles, borders, or text boxes around callouts.
Do not use labels for simple cases when you call out only one item. Describe the item in the text of the article; not in the image.
Use Open Sans 10pt, black font, and align text to the left.
Note: Font size may vary depending on the image resolution. Note: Do not mix fonts and styles in callout text. Enable and configure Clear Type by performing the following actions:
In the Start menu, search for clear type.
Click Adjust ClearType Text, and follow the wizard.
Write the callout text in the white space that surrounds the screenshot. Do not write on any of the UI elements of the figure.
Use terse, sentence case labels or instructions.
Use full sentences for callouts. Capitalize the first word and add sentence punctuation (including a full stop at the end).
Do not include company sensitive information in any screenshot. Use the Blur tool to hide that information.
Disable all browser menu toolbars and status bars to maximize the screen's real value.
To indicate the order for a set of actions (processes and flows), use arrows. Do not insert numbered diagrams.
Use right angles to avoid drawing over layered screenshots if necessary.
Avoid cutting any UI elements that are visible in the screenshot with callout lines.
Try to limit the number of callouts in a screenshot, based on the size and complexity of the screen.
To remove excess noise from a graphic, use the trim feature available on the Images tab in Snagit Editor.
Resize images before adding callout text.
Use styles provided by Pega Community.
General settings
Selections and lines
Highlights
Font
Language
Content
Design



Previous topic Requirements for image files Next topic Selection and line settings