> For the complete documentation index, see [llms.txt](https://docs.norrnext.com/norrcompetition/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.norrnext.com/norrcompetition/modules/norrcompetition-contests.md).

# NorrCompetition Contests

NorrCompetition Contests module displays a list of contests.

The **NorrCompetition Contests** module displays a list or grid of contests filtered by category or status and sorted by various criteria.

<figure><picture><source srcset="/files/DiYj5aiwM63gY65hNVlH" media="(prefers-color-scheme: dark)"><img src="https://4110454137-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FemWP543OtNCmlHpJBjKV%2Fuploads%2Fgit-blob-d415340636d0c7084b7ee155889283de27cc1496%2Fnc-module-contests-min.png?alt=media" alt="NorrCompetition Contests module - settings"></picture><figcaption><p>Contests module settings</p></figcaption></figure>

### Basic Options

* **Count** - The total number of contests to display in the module.
* **Count Per Row** - The number of contests displayed per row in the grid layout.
* **Title Length** - Truncates the contest title to the specified character length. Useful when long titles break grid alignment.
* **Category** - Select the category from which contests should be displayed, or choose *All Categories*.
* **Status** - Filter contests by status: *All*, *Active*, or *Completed*.
* **Order** - Sort order of contests:
  * *Title Alphabetical* - Sort alphabetically by title.
  * *Ordering* - Use backend ordering from the Contests manager.
  * *Created Date* - Sort by contest creation timestamp.
  * *Start Date* - Sort by contest start date.
  * *End Date* - Sort by contest finish date.
* **Order Direction** - Sort direction: *Ascending* or *Descending*.

### Contest Display Options

* **Image** - Show or hide the contest cover image.
* **Description** - Show or hide the contest description.
* **Info** - Master toggle to show or hide the contest metadata block. If disabled, all dependent metadata fields below will not be rendered.
* **Type** - Show or hide the contest type (*Simple*, *Photo*, *Video*). *(Requires Info enabled)*
* **Category** - Show or hide the category title. *(Requires Info enabled)*
* **Link Category** - Display the category title as a clickable link leading to its category layout. *(Requires Info enabled)*
* **Status** - Show or hide the current contest status badge (*Active* or *Completed*). *(Requires Info enabled)*
* **Created Date** - Show or hide the contest creation date. *(Requires Info enabled)*
* **Start Date** - Show or hide the contest start date. *(Requires Info enabled)*
* **End Date** - Show or hide the contest end date. *(Requires Info enabled)*
* **Voting Start Date** - Show or hide the date and time when voting begins. *(Requires Info enabled)*
* **Voting End Date** - Show or hide the date and time when voting ends. *(Requires Info enabled)*

### Advanced Options

* **Alternative Layout** - Select an alternative module layout if one exists in the template or module `tmpl/` directory.
* **Module Class Suffix** - A suffix applied to the CSS class of the module to allow custom CSS styling.
* **Caching** - Choose caching mode: *Use Global* (inherit from global configuration) or *No caching*.
* **Cache Time** - The time (in seconds) before the module content is recached.

***

See [live demo](https://norrcompetition.norrnext.com/add-ons/contests-module) of Contests module.

<figure><picture><source srcset="/files/SoWVwgtAWEUsCee7VPsF" media="(prefers-color-scheme: dark)"><img src="https://4110454137-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FemWP543OtNCmlHpJBjKV%2Fuploads%2Fgit-blob-cecfc0307bb7e9a8d2df79f9d54bb93aacb591f8%2Fnc-module-contests-front-min.png?alt=media" alt="Contests module - front-end"></picture><figcaption><p>Contests module - front-end</p></figcaption></figure>
