---
title: "Group news records"
manual: "News system"
version: "main"
permalink: "https://docs.typo3.org/permalink/georgringer/news:templatesgroupnews@main"
source: "Tutorials/Templates/GroupNewsRecords/Index.rst"
rendered: "2026-09-23T19:24:09+00:00"
---

# Group news records {#templatesgroupnews}

> [!TIP]
> This is a feature delivered by Fluid, so you can use it also in other extensions and projects.

The following example will group all given news records by the property "firstCategory".

```html
<f:if condition="{news}">
   <f:then>
      <div style="border:1px solid red">
         <f:groupedFor each="{news}" as="groupedNews" groupBy="firstCategory" groupKey="cat">
            <div style="border:1px solid blue;padding:10px;margin:10px;">
               <h1>{cat.title}</h1>
               <f:for each="{groupedNews}" as="newsItem">
                  <div style="border:1px solid pink;padding:5px;margin:5px;">
                     {newsItem.title}
                  </div>
               </f:for>
            </div>
         </f:groupedFor>
      </div>
   </f:then>
   <f:else>
      <div class="no-news-found">
         <f:translate key="list_nonewsfound"/>
      </div>
   </f:else>
</f:if>
```

## Keep an eye on performance! {#keep-an-eye-on-performance}

To be able to group the records, Fluid will load every record itself and
groups those afterwards.

If you plan to group many records just for getting something like a count,
maybe it is better to fire the query directly and don't use Fluid for that.

However if the result is on a cacheable page, the issue is only relevant on the
first hit.