> 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-entries.md).

# NorrCompetition Entries

NorrCompetition Entries module displays entries using different sorting and filtering options.

The **NorrCompetition Entries** module displays a customizable grid or list of contest entries, with support for standard contest queries, custom field value filtering, and Grand Prix winner spotlights.

<figure><picture><source srcset="/files/yv0LLHmNvoilM6kc8BqT" 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-3c2b6f4778e1e99a0a6df13b30c275d0d9b75659%2Fnc-entries-module.png?alt=media" alt="NorrCompetition Entries module - options"></picture><figcaption><p>Entries module - options</p></figcaption></figure>

### Module Mode

* **Mode** - Select the display mode for the module:
  * **Entries** - Standard display of entries from all or selected contests.
  * **Field** - Display entries based on a specific custom field value.
  * **Grand Prix** - Display the entry that has been awarded Grand Prix status.

### Basic Options

* **Count** - The total number of entries to display in the module *(hidden in Grand Prix mode)*.
* **Count Per Row** - The number of entries to display per row in the grid layout *(hidden in Grand Prix mode)*.
* **Contest** - Select the contest from which entries should be displayed. Choose *All Contests* or select a specific contest. In *Field* and *Grand Prix* modes, selecting a specific contest is required.
* **Use Contest Params** - If set to *Yes* (when a specific contest is selected), layout-related options (such as vote counts, contestant names, and sharing) will be inherited directly from the contest configuration. If set to *No*, you define these settings individually in the module.
* **Selection Field** - Select the custom field used for entry filtering *(Field mode only)*.
* **Field Value** - Define the required value for the selection field. Only entries matching this custom field value will be displayed *(Field mode only)*.
* **Title Length** - Truncates the entry title to the specified number of characters.
* **Votes** - Show or hide the total vote count for the entry.
* **Average Rating** - Show or hide the average rating score of the entry (for rating-based contests).
* **Voting** - Show or hide the interactive vote/rate button directly within the module.
* **Share** - Show or hide social media sharing buttons (Facebook, X/Twitter, Pinterest, VK).
* **Play Video** - Enable inline video playback or display the video thumbnail for video entries.
* **Contestant** - Show or hide the contestant (author) who submitted the entry.
* **Contestant Title** - Choose how the contestant's name is displayed: *Name* or *Username*.
* **Entry Field** - Select a custom field whose value will be displayed under the entry title *(Entries mode only)*.
* **Field Length** - Truncates the custom field value to the specified character limit.
* **Order** - Select the ordering criteria for entries:
  * *Rating* - Sort by votes / rating.
  * *Title* - Sort alphabetically by entry title.
  * *Ordering* - Sort according to the backend manual order.
  * *Created Date* - Sort by submission timestamp.
  * *Random* - Display entries in random order.
* **Order Direction** - Sort direction: *Ascending* or *Descending*.
* **Description** - Show or hide the Grand Prix description *(Grand Prix mode only)*.

### 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 for custom 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/entries-module) of Entries module.

<figure><picture><source srcset="/files/rR03kNRGXnRqyVITqRqP" 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-5a18cb03c76948e826b387a3e6d47430c63a4bde%2Fnc-module-entries-front-min.png?alt=media" alt="Entries module - front-end"></picture><figcaption><p>Entries module - front-end</p></figcaption></figure>
