How to Create Your First Calendar on Joomla with EventBlender

Getting Started With EventBelnder on Joomla

How to Create Your First Calendar on Joomla

Put a month of events on a Joomla page in about ten minutes. First you type a few events into the EventBlender editor button and choose one of the calendars that come with it. Then you design a calendar of your own in the online Calendar & Timeline Wizard, bring it to your site and publish it. Last, you see where else the events can come from.

The plan

1

A calendar in five clicks

The editor button takes your events and a ready-made calendar design, a ruleset, and writes the calendar into the article.

2

Your own design

The Calendar & Timeline Wizard on tabulizer.com builds a ruleset in your colours and with the options you choose. Download it as a data source and import it.

3

Your own events

A data source can read the events from a file, a spreadsheet, a database, a Google Calendar and more.

Everything below was made on a Joomla 5 site with EventBlender; the steps are the same on Joomla 3, 4 and 6. Tabulizer 7 and later include every EventBlender feature, so with Tabulizer, read Tabulizer wherever this page says EventBlender.

EventBlender comes with twelve calendar and timeline rulesets: Monthly Calendar, Monthly Calendar - Minimal, Weekly Calendar, Weekly Calendar - Compact, Daily Calendar, Agenda List, Year Overview, Combined Calendar, Vertical Timeline, Vertical Timeline - Modern, Horizontal Timeline and Horizontal Timeline - Classic. You find them under Components › EventBlender, each title starting with EventBlender:.

Part 1, step 1: open the EventBlender button

Create a new article (Content › Articles › New), give it a title and a line of introduction, and put the cursor where the calendar should go. Open CMS Content in the editor toolbar and choose EventBlender.

The CMS Content menu of the Joomla article editor opened, listing Article, Contact, Field, Media, Menu, Module, Page Break, Read More and, at the bottom, EventBlender.

Step 2: choose New Static Display

The wizard opens at Step 1: Choose Publishing Mode. Choose New Static Display and press Next. A static display is written into the article as HTML, so it needs nothing else on your site to show.

Step 1 of the EventBlender editor wizard, Choose Publishing Mode, with the New Static Display card selected and the start of the Restyle Existing HTML Table card underneath, and the Cancel and Next buttons.

Step 3: type your events

In Step 2: Select Data Source, choose Typed Text / CSV and press Next.

Step 2 of the EventBlender editor wizard, Select Data Source, with Typed Text / CSV selected in a list that also offers CSV File, Excel File, Database Query, Google Calendar / ICS and other sources.

In Step 3: Configure Data Source, paste your events, one per line, with a first line naming the columns:

date,title,start_time,end_time,category,location,description
2026-11-04,Beginners' workshop,18:00,20:00,Workshops,Room A,An introduction for new members
2026-11-07,Autumn concert,19:30,22:00,Concerts,Main hall,Our choir with guest musicians
2026-11-12,Members' meeting,17:00,18:30,Meetings,Room B,Plans for next year
2026-11-14,Photography walk,10:00,13:00,Outdoors,Old harbour,Bring a camera or a phone
2026-11-18,Beginners' workshop,18:00,20:00,Workshops,Room A,Part two
2026-11-21,Charity bake sale,09:00,14:00,Outdoors,Town square,Proceeds go to the local shelter
2026-11-26,Film night,20:00,22:30,Concerts,Main hall,A classic comedy with popcorn

The calendar finds each piece of an event by its column name, so the order of the columns does not matter. Open Column names the calendar reads at the top of the step for the full list; the ones you will use most are:

Column What it holds
date (required) The day of the event, as YYYY-MM-DD.
title (required) The name shown on the calendar.
start_time, end_time Times as HH:MM. Leave them out for an all-day event.
end_date The last day of an event that runs over several days.
category Events of one category share a colour, and visitors can filter by category.
location, description, url Shown when a visitor opens the event.
repeat, repeat_until For an event that comes back daily, weekly, fortnightly, monthly or yearly, and the last day it does.

Step 3 of the EventBlender editor wizard, Configure Data Source, with the collapsed Column names the calendar reads section, a note that the full data source form offers caching and column mapping, and the hint to paste the data in CSV format.

Commas inside a value are fine as long as the value is in double quotes, for example "Room A, first floor".

Step 4: choose a calendar

In Step 4: Select Ruleset, choose EventBlender: Monthly Calendar in both the Archive and the Ruleset list and press Next. Any of the other eleven works with the same events, so try a timeline or the agenda list later.

Step 4 of the EventBlender editor wizard, Select Ruleset, with EventBlender: Monthly Calendar chosen as the Archive and as the Ruleset, and the Back, Cancel and Next buttons.

Step 5: insert it

Step 5: Confirm & Insert sums up your choices. Press Insert Table, then save the article and make sure it is published.

Step 5 of the EventBlender editor wizard, Confirm and Insert, with a summary table listing the mode New Static Display, the data source Typed Text / CSV, the archive and ruleset EventBlender: Monthly Calendar and the source parameter separator cm.

The result

Open the article on your site. The calendar opens on the month of the first upcoming event, with a button per category, arrows and a month and year jump to move around, and Export .ics to copy the events into a visitor's own calendar.

The Upcoming events article on the Joomla front end: a November 2026 month grid with the Today and arrow buttons, the month and year menus, Export .ics, the category buttons Workshops, Concerts, Meetings and Outdoors, and the seven events as coloured pills on their days.

Click an event to see all of it:

The Autumn concert event opened in a dialog over the month grid, listing the date Saturday 7 November 2026, the time 19:30 to 22:00, the location Main hall, the category Concerts, the description and an Add to calendar button.

A static display is a snapshot: the events are written into the article. To change them, open the article, select the calendar and run the EventBlender button again. When the events change often, or when you want a design of your own, go on to part 2.

Part 2, step 1: choose a layout online

Log in to tabulizer.com and open Wizards › Calendars & Timelines Wizard. In step 1 (Layout), pick a layout - the example uses Combined Calendar, which lets visitors switch between month, week, day and agenda - and press Next step.

Step 1 of the online Calendar and Timeline Wizard with twelve layout cards, from Monthly Calendar to Horizontal Timeline - Classic, and the Combined Calendar card selected and ticked.

Step 2: make it yours

Step 2 (Customise) holds every option of the layout. Start with a Colour preset - the example uses Forest - and adjust single colours if you like; the wizard checks that text stays readable. Further down you set the heading above the calendar (here Club events), the first day of the week, the time format, whether to show category filters, a search box and the calendar export.

Step 2 of the online Calendar and Timeline Wizard, Customise: the Colour presets Ocean, Forest, Sunset, Plum, Slate and Midnight, then the Colours section with a green primary colour, an accent, a white background and dark text, both passing the WCAG AA contrast check.

At the end of the step, Sample data holds the events the preview shows. Paste the same CSV as in part 1; it travels with the ruleset as your first set of events.

The Sample data section at the end of step 2, with the Events (CSV) box holding the header line and the seven club events, the Restore the example data button, and an empty Custom CSS box.

Step 3: preview and save

Step 3 (Preview & Export) shows the calendar exactly as it will look on your site. Try the views and the category buttons.

The live preview in step 3 of the online wizard: the Club events heading, Month, Week, Day and Agenda buttons, the category buttons and a November 2026 month grid in the Forest colours with the club events on their days.

Below the preview, give the ruleset a title and a description and press Save & download ruleset.

The save form below the preview, with the Ruleset title Club events calendar, the description Month, week, day and agenda views in the club colours, an empty notes box, and the Previous step, Save and download ruleset and Start over buttons.

You land in the Ruleset Manager. This first time, press Download as Data Source: you get one zip with the ruleset, its styles, your events as a CSV file and a data source that ties them together.

The Ruleset Manager on tabulizer.com with the message Your ruleset has been saved, the Download Ruleset and Download as Data Source buttons, and the Club events calendar ruleset at the top of the list.

Step 4: import it into Joomla

In your Joomla administrator go to Components › EventBlender, press Import Archive and choose the zip.

The Ruleset Archive Import page of EventBlender with the file ds_2203643a.zip chosen and both Overwrite boxes ticked: overwrite any other existing files with the same name, and overwrite safemode settings.

Tick "YES, overwrite safemode settings". EventBlender starts with Safe Mode on, and Safe Mode does not import data sources. Without the tick the ruleset arrives but the import stops with "Importation error: You cannot import data sources because the Safe Mode is enabled." The tick lifts Safe Mode for this one import and leaves the setting as it was. Use it only for archives you downloaded from tabulizer.com yourself.

Press Import. The ruleset joins the list, and under Data Sources you find a new one named after it:

The Data Sources page of EventBlender in Joomla, listing the Club events calendar data source with its tag n7wKWyvwhqO5FSXiCB7a8j9F, Source Type CSV/Text File, and the actions Preview, Edit, Delete and Publishing Preferences.

Step 5: put it in an article

Create another article, put the cursor where the calendar should go and open CMS Content › EventBlender again.

1

Choose the mode

Choose Existing Calendar / Timeline and press Next.

2

Pick the data source

Select Club events calendar in the Data Source list and press Next.

3

Insert it

Check the summary and press Insert Table.

Step 1 of the EventBlender editor wizard scrolled down, with the New Dynamic Calendar / Timeline card and the selected Existing Calendar / Timeline card, whose text says the data source is already created and the calendar is rendered live.

Step 2 of the EventBlender editor wizard, Select Data Source, with Club events calendar (csv) chosen in the Data Source list, its tag shown underneath and the start of the Optional User Parameters section.

Step 5 of the EventBlender editor wizard, Confirm and Insert, with the mode Existing Calendar / Timeline, the data source Club events calendar with its tag, no source parameters, and the Insert Table button.

This time the article holds only a short tag. The tag is replaced with the calendar every time the page is shown, so the calendar always shows the current events.

The Joomla article editor with the line Browse our events by month, week, day or as an agenda, followed by the inserted tag {eventblender:data_source[n7wKWyvwhqO5FSXiCB7a8j9F]}.

Save the article and open it on your site.

The result

The Club calendar article on the Joomla front end: the Club events heading, the green Month button among Week, Day and Agenda, the category buttons and the November 2026 month grid with the club events in the Forest colours.

Visitors switch views with one click. The agenda lists every event with its time, place and description:

The same calendar in the Agenda view, covering 4 November to 3 December 2026, listing each event by day with its title, time, location, description and a coloured category label.

To change the events, change the data source's CSV file: open the data source and use Edit inline, or upload a new version under Data Sources › Manage Data Files. To change the design, edit the ruleset on tabulizer.com, download it with Download Ruleset and import it with Overwrite ticked.

Part 3: where else the events can come from

A CSV file is only the start. The calendar shows any data that has a date and a title column, whatever the source. Go to Components › EventBlender › Data Sources, press New Data Source and open the Source Type list to see all of them:

The Source Type list of a new EventBlender data source, from CSV/Text File, Excel File, HTML file or Webpage, XML file, RSS Feed and JSON through Database Table/Query, Joomla Article and Form Entries to Google Spreadsheet and Google Calendar (ICS).

Source Type When it suits you
CSV/Text File, Excel File You keep the events in a spreadsheet. Upload the file and replace it whenever it changes.
Google Spreadsheet Several people keep the events up to date. Link a published Google Sheet and the calendar follows their changes by itself.
Google Calendar (ICS) The events already live in Google Calendar, Outlook or any calendar that publishes an ICS address.
Database Table/Query, External Database/Query The events are in a database, kept by another extension or another system.
JSON, JSON File / API, XML file, RSS Feed Another service publishes the events: a booking system, a ticket shop, a news feed.
Form Entries Visitors submit events through a form on your site.
HTML file or Webpage, Joomla Article The events are in a table on a page.
Data Source Merger, Chained Data Source You want to combine several sources in one calendar, or prepare the data in one ruleset before the calendar draws it.

Choose your calendar ruleset in Ruleset Archive and Ruleset Name on the same form, save, and insert the new data source with Existing Calendar / Timeline exactly as in part 2. If your source names its columns differently, the data source can rename them, so there is no need to change the source itself.

Common questions

The import says Safe Mode is enabled.

Import again with YES, overwrite safemode settings ticked. You can also turn Safe Mode off for good under Components › EventBlender › User Preferences, but the tick is the safer habit.

The article shows the tag instead of a calendar.

The EventBlender plugins are disabled. Enable them under System › Manage › Plugins, searching for EventBlender.

The calendar opens on the wrong month.

By default it opens on the month of the first upcoming event. In step 2 of the online wizard, Open on can choose today's date or a fixed date instead.

An event does not appear.

Check that its date is written as YYYY-MM-DD and its times as HH:MM, and that the first line of the data names the columns.

Can I show the same events in two layouts?

Yes. Create a second data source with the same source and another ruleset - say a timeline on the home page and the full calendar on an events page.

Read more

See all twelve layouts working on the Calendars & Timelines demo. More about the data: The CSV/Text File Data Source, The Excel File Data Source, The Database Table/Query Data Source and The Google Spreadsheet Data Source.

Make yours

Open the Calendar & Timeline Wizard, paste a few of your own events and follow the same steps.

Open the Calendar & Timeline Wizard