Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      


Updated on July 27, 2022

Topics are contained within modules and are the most granular level of information. A topic can include static images, diagrams, interactions, and videos. depending on what is required to communicate the material to your audience. On average, a topic should take 5 to 15 minutes for a learner to complete. Five to seven topics can be included in a single module, with a minimum requirement of two topics before the module can be published.

The following Quick Tip video explains what a good topic layout looks like and why it works:

Pega Academy Quick Tip: Topic Best Practices

Here are some best practices to keep in mind when creating a topic:

  • Write for the audience. Design the material to make it relevant and meaningful to the learner by relating what is being learned with what the learner already knows and will use on the job.
  • Keep the material short, concise, and clear.
  • Gain attention through relevant stories, facts, or questions.
  • Chunk up the material into bite size, consumable pieces. For example, if you had 30 seconds to memorize ten numbers, which way is easier?  7-2-9-6-3-4-0-5-2-1 or 729-634-0521?
  • Remember this fact: "...a user will remember 10% of what they read, 20% of what they hear, 30% of what they see, and 90% of what they do." (ref: Edgar Dale).  Be sure to add interactions, simulations, scenario-based testing, and quizzing to aid in the retention of the material.

Topics are conceptual or task-based.

Concept topics

Use concept topics to explain abstract ideas and introduce terminology. Concept topics should provide general explanations, background information, and examples.

Note: Concept topics are usually not affected by product changes. Concept topics may need updating to support new product options and their use cases. but concept topics tend to need less rewriting than task-based topics.

Follow concept topics with at least one task-based topic. Follow concept topics that introduce complex features with other concept or related task topics.

Task topics

Use task topics to describe the steps of a particular task. A task topic answers the question of "how to?" by telling the learner what to do and the order in which to do it.

A task topic contains a single procedure, which is made up of a series of steps. Each step describes a single action or command for the learner to take. A step can also describe the step results.

Note: Most task-based topics are. sourced from Pega Community articles, but you can create a task topic if there is a need.

Include sections for describing the context, the actual steps, and the expected results for the task.

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us