Something missing? Suggest a change or addition



There is a need to ensure that contributions are of good quality.


Oversight of contributions can help to highlight potential quality issues, areas where policy isn’t being correctly applied, or identify spam or malicious edits. Knowing contributions will be reviewed gives users of your data confidence that the project has made efforts to ensure good quality. Knowing contributions will be reviewed builds confidence in contributors.


Design an appropriate process that will provide the project team and your community of contributors with oversight of incoming contributions and the tools necessary to review and act on them.

This pattern is often implemented as a manual review process, in which contributions go into a queue for review by a project team member or an experienced user before they are accepted into the live database.

Introducing a review step builds confidence that quality checks have been carried out prior to data being made available for use or further editing. Introducing this step puts an emphasis on quality over speed of contributions, as the review process – unless it is very quick – will limit how quickly contributors can populate or correct the database.

It is possible to implement moderation as a required stage for all contributions, eg as a Mandatory Review. But moderation can also be optional. Contributors might also Request Reviews.

The system may only apply moderation to specific contributions, by defining some kind of rules to Flag them for Review. This might be based on validating or inspecting the information that has been changed, or contributions that are from new users.

As moderation is typically manual, implementing this pattern implies that the system has a means of indicating which contributors have moderator privileges, eg by assigning an explicit set of rights (Clearly Defined Roles). Where there aren’t defined moderator roles, it may be more efficient to simply do Retrospective Review and rely on contributors to Track Changes to help review contributions.

Communication around moderation will manage contributor’s expectations, and help assure them that their contribution is valued. During the process of making a contribution, and in your Published Policy, you can inform them:

  • How long reviews should take
  • The reasons why contributions have been rejected or how to improve them
  • Who is making the decisions

When moderation is complete, the reviewer will need to accept the change for it to be accepted into the database. If moderation involves a Changeset Discussion between contributors which results in the entry being revised, eg to fix a data error, then the process for completing the review and accepting the change should be made clear.

Reviews can be made by humans or machines, or a hybrid of both. Humans can provide feedback via a Changeset Discussion, whereas machines can carry out** Automated Consistency Checks** to surface common errors. To further reduce data quality issues, Field Validation helps to capture common errors.

Contributors can review large numbers of Changesets by following Tracked Changes on Watch Lists, or by setting parameters to Flag Reviews, such as those of new users. If the project does not provide ways to rank, filter and sort changes, Extensible Tooling could provide ways to manage lists.

Related patterns

Mandatory Review

All entries need to be correct and adhere to policy.

Retrospective Review

Contributions need to be encouraged and made available as soon as possible after having been submitted.


Multiple collaborators independently making entries into a database makes it difficult to understand how the dataset reached its current state.

Something missing? Suggest a change or addition