Anyone who works with large TYPO3 installations will recognise the problem: the Records module shows records as a table. That works, but it gets hard to read once you are dealing with hundreds of news articles or products. The Records List Types extension fixes this with three extra view modes that add thumbnails and drag & drop, making everyday work noticeably faster.
Table of Contents
Why a List View
New view modes
Features
Grid, Compact, Teaser, Custom Views
Custom View Types
PSR-14 Event, TSconfig, Fluid
Architecture
View Mode Switching Flow
Security
Input Validation, CSRF, Access Control
Summary
Open Source, Extension
Why a New List View?
TYPO3's standard list module is solid, but it offers only one way of presenting records. For image-heavy content such as news, products, or galleries, there is no visual cue to go on. The extension adds grid, compact, and teaser views, so editors can pick whichever one best suits their workflow.
View Modes
Card Layout with Thumbnails
The grid view displays records as cards with preview images. Suitable for:
- News articles with teaser images
- Products in an e-commerce context
- Media assets such as image galleries
Drag & Drop Sorting
A genuine time-saver: records can be reordered by drag & drop, with no need to fiddle with sorting fields or manual position values. The new order is saved to the database straight away. This is especially handy when working with image galleries or product lists.
Features at a Glance
Grid View
Visual cards with thumbnails and drag & drop sorting.
Compact View
More records per page – ideal for large lists.
Teaser View
Card format with title, date, and description for editorial content.
Custom Views
Register custom view types via PSR-14 events or TSconfig.
User Preferences
The preferred view is saved per account and automatically restored at the next login.
Dark Mode
Full compatibility with TYPO3's dark mode.
Per-Table Config
Configure fields individually per table via TSconfig.
Ready to Use
Works straight after installation – fine-tuning is optional.
Security
Input validation, CSRF protection, access control.
Installation
- TYPO3 v14.0+
- PHP 8.3+
After activation, the view mode buttons will appear in the header of the Records module.
Configuration via TSconfig
Defining Fields per Table
TSconfig lets you control exactly which fields appear in the grid or teaser view:
Setting the Default View
The selected view is saved per user and is automatically restored the next time they log in.
Developing Custom View Types
The extension is designed to be extended. A custom view consists of three components:
Architecture Overview
Architecture: View Mode Switching Flow
Security
The extension follows the TYPO3 Security Guidelines:
- Input Validation: User inputs are validated and sanitised
- SQL Injection Prevention: TYPO3's QueryBuilder with parameterised queries
- CSRF Protection: AJAX endpoints utilise TYPO3's token handling
- Access Control: Compliance with backend user permissions
Documentation & Resources
| Document | Description |
|---|---|
| README.md | Full documentation with screenshots |
| Architecture.md | Technical architecture and component diagrams |
| Configuration.md | Complete TSconfig reference |
| CustomViewTypes.md | Creating custom view types |
| Extending.md | Extension points and PSR-14 events |
Summary
Records List Types makes the TYPO3 backend more flexible. Three view modes, drag & drop, and persistent user preferences improve everyday editorial work, with no configuration required after installation.
What you get:
- Three pre-configured view modes: grid, compact, teaser
- Drag & drop sorting in the grid view
- Extensible with custom view types (PSR-14 / TSconfig)
- Persistent user preferences and dark mode
The extension is licensed under the GPL-2.0 licence and is freely available. We welcome feedback and contributions.