The Event Types view displays published events that are assigned to one selected JEM event type. It is useful when visitors need to browse events by format, audience, topic, or any other type-based classification used by the site.
Event types are not the same as categories. Categories remain the main event structure in JEM, while event types provide an additional way to classify and browse events.
Where to Create This View
Open the Joomla administrator and create a new Joomla menu item. Select JEM → Types → Event Types, then choose the event type that should be displayed by the menu item.
The selected type must be a published JEM type for events. Venue types and category types are not available in this menu item selector.
When to Use Event Types
Use this view when a type deserves its own frontend page instead of being only a value shown inside a general event list.
| Scenario | Recommended use | Why |
|---|
| Programme by format |
Create separate pages for concerts, workshops, lectures, or meetings. |
Visitors can browse one event format without using a search filter. |
| Audience-based events |
Use types such as family, professional, students, or members. |
Creates focused pages for different visitor groups. |
| Landing pages |
Link promotional pages directly to one event type. |
Keeps campaigns and menus simple while still using normal JEM event data. |
| Large event directories |
Use event types alongside categories and venues. |
Gives visitors another structured way to browse the same event collection. |
What the View Shows
The page starts with the selected type information and then displays a normal event list filtered by that type.
- Type heading: shows the selected event type name.
- Type icon: can be shown when the type has an icon configured.
- Type description: appears below the type heading when entered in the backend.
- Event table: shows published current, future, or unfinished events assigned to the type.
- Pagination: appears when the result list is longer than the configured page limit.
The Event Types view is a list view, not a map view. For a map-first display, use the dedicated Events Map view.
Menu Item Options
The Event Types menu item includes options for the selected type and for text shown before or after the event list.
| Option | Purpose |
|---|
| Event type |
Selects the published event type used to filter the page. |
| Show intro text for events |
Controls whether event intro text is shown in the list, depending on the layout. |
| Show month row |
Adds month grouping rows to the event list when enabled. |
| Intro text |
Optional text displayed above the filtered event list. |
| Footer text |
Optional text displayed below the filtered event list. |
Filters and Ordering
The Event Types view uses the event list filter interface. The available filter fields depend on JEM settings and menu configuration.
- The search box can search within the selected filter field.
- Possible filter fields include title, venue, city, and category when those columns are enabled.
- The default ordering is by event date in ascending order.
- The selected event type is always applied as the main filter for the page.
In current JEM versions, the Event Types view clears unrelated category, venue, country, and featured filters inherited from fallback menu items. This helps the page show all matching events for the selected type.
Access, Language, and Visibility
Both the type and the events must be visible to the current visitor. If the selected type is not published, not accessible, or not valid for events, the page cannot show its event list.
- The type must be published and assigned to the event entity.
- The type access level must allow the visitor to view it.
- Language settings must match the current site language or be set to All.
- Events must also be published, accessible, and assigned to visible categories.
- Past or archived events are not shown by this view unless they are still considered unfinished.
Map-Related Behaviour
Event type pages can list events that have venues and coordinates, but they do not replace the Events Map view. Use the Events Map view when the map itself should be the main interface.
- Map display depends on the event, venue, coordinates, and the selected JEM view.
- If visitors need a map filtered by event type, use a dedicated map view or a menu structure that supports that workflow.
- If a map button or map area is expected but missing, check the event venue and coordinate data first.
Customization
The Event Types view can be customized with normal JEM settings, Joomla menu item options, custom CSS, and template overrides.
- Use backend type settings to manage the type name, description, icon, color, and publication state.
- Use JEM layout settings and menu item options before creating template overrides.
- Use custom CSS for spacing, colors, icons, and responsive adjustments.
- Use a Joomla template override only when the HTML structure of the view must change.
Useful CSS targets include the Event Types page wrapper, the event list table, the type heading, the type icon, and any custom classes added through the active Joomla template.
Troubleshooting
The type does not appear in the menu item selector
- Check that the type is published.
- Check that the type is configured as an event type, not a venue or category type.
- Check access and language settings if the backend list appears filtered.
The page opens but no events are shown
- Check that events are assigned to the selected event type.
- Check event publication state, access level, language, dates, and categories.
- Check whether the events are past or archived.
- Clear Joomla cache after changing type or menu settings.
Search or filters do not show the expected fields
- Review the event list display settings for title, venue, city, and category columns.
- Check whether a template override hides the filter area.
- Check the menu item and global JEM layout settings.
A map is expected but not shown
Use the Events Map view for a map-first page. If a layout or override adds map actions to an event type page, confirm that the related venues have valid latitude and longitude values.
Related Project Notes
- #2163 documents why event type pages must not accidentally inherit unrelated menu filters.
- #2152 relates to publication status handling in backend venue and type listings.
- #2030 is relevant to type data during import, export, and search workflow changes.
Related Documentation
