> 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/contests/contest-layout-options.md).

# Contest Layout Options

Learn how to configure and customize contest page layouts in NorrCompetition.

NorrCompetition provides comprehensive layout customization for contest pages. When creating or editing a contest, the **Layout Options** tab allows overriding global display settings specifically for that contest. By default, all parameters inherit their values from Global Configuration (*Use Global*).

### Contest Header & Countdown Timers

<figure><picture><source srcset="/files/7DZ12C5VnBvNjqoTP7d1" 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-0e5f60d43442c33ba80321c253e488211c11e649%2Fnc-creating-contest-layout-options-min.png?alt=media" alt="NorrCompetition Contest Layout Options"></picture><figcaption><p>Contest Layout Options</p></figcaption></figure>

* **Title** – show or hide the title of the contest.
* **Description** – show or hide the contest description.
* **Contest Start Timer** – display a live countdown timer until the contest start date.
* **Contest End Timer** – display a live countdown timer until the contest closing date.
* **Voting Start Timer** – display a countdown timer until voting opens.
* **Voting End Timer** – display a countdown timer until voting closes.

<figure><picture><source srcset="/files/Hzvesj6PUMocj73RpaSr" 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-c9960268f5e118b39f3802121ab75b409b34340d%2Fnc-contest-timer-min.png?alt=media" alt="NorrCompetition Contest layout - front-end"></picture><figcaption><p>Countdown Timers on Frontend</p></figcaption></figure>

### Listing Options (Entry Grid)

<figure><img src="https://4110454137-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FemWP543OtNCmlHpJBjKV%2Fuploads%2Fgit-blob-8b279a680234883a71ff10979e5bdbff81ffa751%2Fnc-creating-contest-layout-options-listing1-min.png?alt=media" alt="NorrCompetition - Contest Layout options - Listing options"><figcaption><p>Listing Options</p></figcaption></figure>

* **Voting Button** – display the vote/rate button directly within entry cards in the grid.
* **Votes Count** – display total votes received on each entry card.
* **Average Rating** – display the average star rating on entry cards (active when *Vote Mode* is set to *Rating*).
* **Share Button** – display social share buttons on entry cards.
* **Play Video** – embed inline video players directly in the grid for video contests instead of static video thumbnails.
* **Masonry** – enable dynamic Masonry grid layout, eliminating gaps when entries or image cards have varying heights.
* **Show Entries Before Voting** – control entry visibility prior to voting start. Hiding entries before voting begins helps prevent plagiarism and early bias.
* **Total Entries** – display total approved entries counter badge.
* **Submitter** – display contestant author name on entry cards.
* **Submitter Name Format** – format contestant display name as real *Name* or Joomla *Username*.
* **Entries per Row** – number of columns/entries per grid row.
* **Entries per Page** – pagination limit defining how many entries appear per page.
* **Title Length** – truncate long entry titles to a specific character limit.
* **Custom Field** – select a custom field to display as a badge or secondary line under the entry title.
* **Field Length** – maximum character length for the selected custom field value.

<figure><img src="https://4110454137-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FemWP543OtNCmlHpJBjKV%2Fuploads%2Fgit-blob-1e27da1d0ef2f8ac05db6665534bb9c82a795a6f%2Fnc-creating-contest-layout-options-listing2-min.png?alt=media" alt="NorrCompetition - listing options - front-end"><figcaption><p>Entry Grid on Frontend</p></figcaption></figure>

### Completed Contest Options

<figure><picture><source srcset="/files/OjBq07taOvvhUbUTwoz2" 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-9a1410550f69bc2aba977b98bf47f73101a584a6%2Fnc-creating-contest-layout-options-completed.png?alt=media" alt="NorrCompetition - Completed Contest Options"></picture><figcaption><p>Completed Contest Options</p></figcaption></figure>

* **Entries in Result** – number of top-voted winning entries displayed prominently in the results podium.
* **Grouping Field** – select a custom field (such as "City", "Age Group", or "Category") to group remaining entries when the contest closes. If *None* is selected, entries display in a standard leaderboard list.
* **Entries in Grouping Result** – number of top entries to display per group when grouping by custom field is enabled.

<figure><picture><source srcset="/files/67hs9wa6tzZ7lJLLaphG" 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-952eaaa68146e38ea7d002135dffbd6270b5b191%2Fnc-creating-contest-layout-options-front-min.png?alt=media" alt="Completed Contest. Result on the Front-end"></picture><figcaption><p>Completed Contest Results Grouped by Custom Field</p></figcaption></figure>

### Filtering & Sorting Options

<figure><picture><source srcset="/files/ZCIIaiawJwCiCvOsGOLX" 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-54b618933b3b323dee4603b9b8a9999cd9ef6709%2Fnc-creating-contest-layout-options-filtering2-min.png?alt=media" alt="NorrCompetition - Contest Layout - Filtering options"></picture><figcaption><p>Filtering Options</p></figcaption></figure>

* **Search Filter** – display a search input allowing visitors to search entries by title.
* **Ordering Filter** – display an interactive sorting dropdown on the frontend.
* **Ordering Options** – select which sort criteria are available to visitors (*Votes / Rating*, *Alphabetical*, *Created Date*, *Ordering*, *Random*).
* **Pagination Limit Box** – display a selector allowing visitors to choose how many entries to show per page.
* **Pagination Limit Options** – comma-separated list of limit choices (e.g. `12, 24, 48`).
* **Default Order** – initial ordering criteria (*Votes / Rating*, *Alphabetical*, *Ordering*, *Created Date*, *Random*).
* **Default Order Direction** – *Ascending* or *Descending*.
* **Pagination** – display pagination bar (*Hide*, *Show*, or *Auto*).
* **Pagination Results** – display page counter summary (e.g. "Page 1 of 4").

<figure><picture><source srcset="/files/kUidOlWu0PsxBhi7uZId" 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-e89ed31b1b4a1e031d09fafe98ad83ca080c57ff%2Fnc-creating-contest-layout-options-filtering-min.png?alt=media" alt="NorrCompetition - Contest Layout - Filtering options - front-end"></picture><figcaption><p>Filtering and Sorting Controls on Frontend</p></figcaption></figure>

### Other Options

* **Submit Entry Button** – show or hide the frontend call-to-action button leading to the entry submission form for this contest.
* **Back to Contests List Button** – show or hide the navigation button leading back to the category / contests overview list.

<figure><picture><source srcset="/files/Uj5N5Ni5GDR5ShzInwYQ" 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-4fdc4cd64f9f1b99f1b532d739571313b2ca5d01%2Fnc-contest-other2.png?alt=media" alt="Other Options - front-end"></picture><figcaption><p>Action Buttons on Frontend</p></figcaption></figure>
