CSV import

CSV import uses two files:

1. Channels CSV — contains channel definitions
2. Events CSV — contains events connected to those channels

Channels can be uploaded first. They appear immediately, even before an Events CSV file is selected.

Enable CSV mode

1. Set Demo content to Off.
2. Set Data source to CSV.
3. Select a file in Channels CSV.
4. Select a file in Events CSV.

Ready-to-use example files — the demo conference schedule with 6 channels and 43 events:

• planby-demo-channels.csv
• planby-demo-events.csv

channels.csv format

Column	Required	Description
channel_id	Yes	Unique identifier. Events use this value to select their channel.
name	Yes	Channel name displayed in the schedule sidebar.
logo	No	Public HTTP or HTTPS image URL.

Example:

channel_id	name	logo
innovation	Innovation
discussion-panel	Discussion Panel
ai-track	AI Track

events.csv format

Column	Required	Description
event_id	Yes	Unique event identifier.
channel_id	Yes	Must match a channel_id from the Channels CSV.
title	Yes	Displayed on the tile and in the modal.
start	Yes	Event start date and time.
end	Yes	Event end date and time, later than start.
image	No	Public HTTP or HTTPS image URL.
short_description	No	Displayed only on the event tile.
description	No	Displayed only in the event details modal.
social_1 … social_5	No	Up to 5 external URLs displayed as icons in the modal.

Example:

event_id	channel_id	title	start	end	image	short_description	description	social_1	social_2
event-1	innovation	Opening Keynote	2025-09-13 10:00	2025-09-13 11:00	https://images.example.com/speaker.jpg	Product strategy	"A detailed description of the keynote, speakers, and takeaways."	https://github.com/example	https://www.planbynow.app

Connect events to channels

Every event's channel_id must match a channel_id from the Channels CSV.

channels.csv: innovation
events.csv:   innovation

Letter casing and outer whitespace are ignored. The remaining identifier value must match.

CSV date format

The safest supported format is:

YYYY-MM-DD HH:mm

Examples:

2025-09-13 10:00
2025-09-13 11:30

The T separator and optional seconds are also supported:

2025-09-13T10:00
2025-09-13T10:00:00

Descriptions containing commas

Wrap a value in double quotes when it contains commas:

"A detailed description with speakers, topics, and practical takeaways."

To include a double quote inside a quoted value, write it as "".

Supported CSV separators

The component automatically detects:

• commas
• semicolons
• tabs

It also supports a BOM added by some spreadsheet applications.

Images and social links in CSV

image, logo, and social link values must use public HTTP or HTTPS URLs. A social link can be a plain URL:

https://github.com/example

The Planby Now export format is supported as well:

"github,--,https://github.com/example"

Import limits

Limit	Value
Channels	20
Events per channel	100
Social links per event	5
CSV file size	2 MB

note

Invalid rows are skipped. When part of an import is valid, the component preserves valid channels and events and displays a compact warning about the remaining issues.