title: mediawiki/revision/visibility-change
description: Represents a MW Revision Visibiilty Change event.
$id: /mediawiki/revision/visibility-change/1.0.0
$schema: https://json-schema.org/draft-07/schema#
type: object
allOf:
   ### revision fields - all revision related events should have these.
  - $ref: /fragment/mediawiki/revision/common/1.0.0#
  ### revision/visibility-change specific fields
  - properties:
      chronology_id:
        description: Deprecated - no longer populated
        type: string

      comment:
        description: The comment left by the user that performed this change.
        type: string

      parsedcomment:
        description: >
          The comment left by the user that performed this change
          parsed into simple HTML. Optional
        type: string

      rev_sha1:
        description: The sha1 of the revision text.
        type: string

      rev_len:
        description: The length of the revision text in bytes.
        type: integer

      rev_minor_edit:
        description: Flag identifying if the revision is minor.
        type: boolean

      rev_content_model:
        description: The content model of the revision.
        type: string

      rev_content_format:
        description: The content format of the revision.
        type: string

      page_is_redirect:
        description: >
          True if this revision is a redirect.  This
          fact is ultimately represented by revision content containing
          redirect wikitext.  If this revision is the head revision
          of the page, then the page will also be a redirect.
        type: boolean

      visibility:
        description: The visiblity state of this revision.
        type: object
        properties:
          text:
            description: Whether the revision's text is visible.
            type: boolean
          user:
            description: Whether the author of the revision's text is visible.
            type: boolean
          comment:
            description: Whether the comment of the revision is visible.
            type: boolean
        required:
          - text
          - user
          - comment

      prior_state:
        description: >
          The prior state of the entity before this event.  Revisions always have
          visibility settings, so this object will always contain the visibility
          settings for the revision before this event.
        type: object
        properties:
          visibility:
            description: The prior visiblity state of this revision.
            type: object
            properties:
              text:
                type: boolean
              user:
                type: boolean
              comment:
                type: boolean
            required:
              - text
              - user
              - comment

    required:
      - visibility
      - prior_state
examples:
  - $schema: { $ref: '#/$id' }
    meta:
      uri: https://examplewiki.wikipedia.org/wiki/TestPage10
      dt: '2020-06-10T18:57:16Z'
      domain: test.wikipedia.org
      stream: mediawiki.revision-visibility-change
    database: examplewiki
    page_id: 123
    page_title: TestPage10
    page_namespace: 0
    rev_id: 123
    rev_timestamp: '2020-06-10T18:57:16Z'
    rev_sha1: mr0szy90m5qbn6tek7ch3nebaild3tm
    rev_minor_edit: false
    rev_len: 3
    rev_content_model: wikitext
    rev_content_format: text/x-wiki
    performer:
      user_text: example_user_text
      user_groups:
      - "*"
      - user
      - autoconfirmed
      user_is_bot: false
      user_id: 123
      user_registration_dt: '2016-01-29T21:13:24Z'
      user_edit_count: 1
    page_is_redirect: false
    rev_parent_id: 122
    rev_content_changed: true
    visibility:
      text: false
      user: true
      comment: true
    prior_state:
      visibility:
        text: true
        user: true
        comment: true