XWiki's User Experience

Last modified by Thiago Krieck on 2026/11/18 14:22

Welcome to the home of XWiki's user experience work. This is where we explain how XWiki's interface is designed, the standards that keep it consistent, and how to report and label the problems users run into. Everyone is welcome to take part: users, developers and designers.

UI Standards

How the XWiki interface should be built. (Work in progress).

Design process

How improvements are planned, discussed and turned into proposals.

UX topics

User experience, usability, consistency, standards and accessibility, and how they relate.

Report an issue

Help us find UX problems, and label them in Jira so that they reach the right people.

Design process

The process involves the creation of specifications, analysis, mockups, partial prototypes and even final versions of the proposals made. The aim of these proposals is to improve XWiki's interface, look & feel, usability, experience and interaction.

  • Planning: Design planning for improvements and features follows the current XWiki Roadmap.
  • Discussions: Design discussions happen on the XWiki Chat or on the XWiki forum. On the forum, design discussions are in the Development category, with proposal and/or ux as labels.
  • Proposals: Design proposal deliverables (use cases, requirements, mockups, prototypes) are on the Design wiki, for example Proposal: Flamingo Skin.
  • Standards: Once agreed, the rules for building the interface are documented in the XWiki UI Standards.

UX topics

UX work at XWiki is split into topics that fit inside each other, from the broadest to the most specific.

User Experience is the broadest one: it investigates users' behaviour and answers the question, “Did the user have as delightful an experience as possible?” It encapsulates all the other topics, but being so broad, it is also very hard to define and to quantify by marking Jira issues. That's why the ux label is not recommended: it is more specifically defined by the usability label.

Usability is a subset of the overall User Experience. It answers the question, “Can the user accomplish their goal?”, with effectiveness and efficiency: does the user have problems accomplishing their tasks?

Two topics are subsets of Usability:

  • Accessibility: Are there accessibility problems users are facing while using the product?
  • Consistency: Are there elements that define or break the interface consistency? Standards are related to Consistency: they are the rules that standardise the interface elements, documented in the XWiki UI Standards.

When labelling an issue, choose the most specific topic. The labels for each topic are listed below.

Issues labels

You can contribute and help us report issues within XWiki. Several labels can be added to a Jira issue to mark it as important from a user experience point of view: ux, usability, consistency, standard and wcag.

TopicWhat it meansLabelAsk yourself
User experience (UX)A person's behaviours, attitudes and emotions about using a particular product, system or serviceux, not recommendedIs the user not having a great or delightful experience using the product?
UsabilityThe ease of use and learnability of a human-made objectusability, recommendedDoes the user have problems accomplishing their task?
ConsistencyThings that are related should be presented in a similar wayconsistencyAre there elements that define or break the interface consistency?
StandardDefining elements that will be reused throughout XWiki (like .xform) and applying them to existing interface elementsstandardAre there elements that define or break the interface standard?
AccessibilityPeople with disabilities can perceive, understand, navigate and interact with websites and tools, and can contribute equally without barrierswcag, recommendedAre there accessibility problems users are facing while using the product? See how to report an accessibility issue.

Defining a usability issue

  • Usability issues refer exclusively to interface and front-end issues, since only these issues affect the end user directly.
  • The generic definition of a usability issue is an issue that prevents the user from completing a task. This means the functionality is not usable, and thus useless.
  • Improvements on a specific functionality are also considered usability issues if implementing them provides an obvious benefit to the user: making things clearer and easier to use, improving learnability, improving the way the user interacts with the system, boosting productivity, etc.
    • Most Improvement issues are usability improvements, but this doesn't mean that Bugs or New Features cannot be labelled as usability issues. Also, some Improvements are not usability issues.
  • So, in general, usability issues are front-end improvements that provide functionality that enhances the user's interaction with the product.

Get Connected