Hide navigation sidebar
Hide table of contents sidebar
Skip to content
Back to top
View this page
Toggle table of contents sidebar

# Reference

## Contributors directive

.. contributors:: username/repository
  :limit: (integer)

    Number of contributors to list, between 1 and 100. The default value is 10.

    Added in version 0.2.2.

  :order: (string)

    Results are sorted by the number of contributions. This parameter controls whether they are sorted by most active users first (`DESC`) or least active users first (`ASC`). Default is `DESC`.

    Added in version 0.2.2.

  :avatars: (boolean)

    Whether to include an image with the avatar returned by GitHub. Use CSS to customize the image size, since the returned images might vary.

    Added in version 0.2.3.

  :contributions: (boolean)

    Whether to show the total number of contributions by each user or not.

    Added in version 0.2.3.