projectdoc Toolbox

User Characters are the actors of user stories. They include personas and extreme characters.

Documentation Type


User characters help to visualize the users of a system. They are closely related to roles, but model real or imagined users that may map to multiple roles.


The document type user character provides the following properties:


Please note that only information about specific properties is provided here. Common document property used by all document types are documented by Document Properties.


The type of the user character.

user roleA user that holds one or more roles.
personaAn imaginary user with detailed background.
extreme characterA very exaggerated persona to help to improve user stories.


The roles the user character , persona, or extreme character holds.

User Type

Select a type for the user with the User Character Type Macro.

Actor Type

The actor type defines how the user character is mainly acting with the system. The information is used to separate the primary (main) user characters ("Primary") from those that are only used in stories that support the system, but not fulfil its main goal. If the user character cares for the system, it is called ''Secondary'', if it provides additional functionality, it is called ''Supporting''.

Image URL

Add a reference to an image for a role or persona to. The URL to an image may be a plain URL or a link that points to an image.

Typically the URL is used to fetch the image and render it using the Display Document Property As Image Macro.



The description of the user character.


Describe the background of the user character in some detail. Sketch out some facts to visualize the context the character lives in. This may include some demographic information.


Since version 3.1.2.


List the needs you assume the user character has from a brainstorming session. This may lead to hypotheses that have to be worked on later.


Since version 3.1.2.

Suggested Solutions

From a brainstorming session add possible solutions to the needs your product may provide or be involved with. Again, these points may not to be taken as granted, but used as a tool to visualize the character.


Since version 3.1.2.

Subordinate User Characters

User characters may be grouped in hierarchies.


These are internal notes that are usually not exported and only visible to team members with write access.

But this is not a safe place to store sensible information. It is just a convenience for the reader to not be bothered with notes stored here for the authors for later use. The security level is about suppressing the representation by a CSS style. Therefore consider this as a convenience for the reader, not as a security tool.


The text of notes sections is also indexed.


For a document the references section contains pointers to resources that prove the statements of the document.

Often these proofs are not easily distinguishable from further information. In this case you may want to skip the reference section in favour for the resource list.


For further information please refer to References and Resources.


The resources section provides references to further information to the topic of the document.

This may be information on the internet provided by the resource or information in the team's information systems. Anything the reader of the resource might want to know, may be listed here.


For further information please refer to References and Resources.

Related Doctypes


User characters are based on roles.

User Story

User characters are actors in user stories.