Skip to main content

Embed a Sequel Event Grid on your website

This article describes how you can create an Events grid that shows upcoming and past events using Sequel

Updated today

The Event Grid Widget allows you to display a beautiful, responsive grid of your company's events on any website. It automatically shows upcoming events for registration and past events with replay functionality.

Quick Start

  1. Add the Sequel script to your website

  2. Add a container div with the correct ID

  3. Call the renderEventGrid function with your company ID

<!DOCTYPE html>
<html>
<head>
<title>My Events</title>
</head>
<body>
<div id="sequel_root"></div>
<script src="https://embed.sequel.io/sequel.js"></script>
<script>
document.addEventListener('DOMContentLoaded', (event) => {
Sequel.renderEventGrid({
companyId: 'your-company-id-here'
});
});
</script>
</body>
</html>

Installation

Direct Script Include

<script type="module" src="https://prod-assets.sequelvideo.com/uploads/toolkit/sequel.js"></script>

Configuration Options

The renderEventGrid function accepts the following options:

Parameter

Type

Default

Description

companyId

string

Required

Your Sequel company ID

darkMode

boolean

false

Enable dark mode styling

excludeText

string

""

Exclude events whose names start with this text

showDescription

boolean

false

Show event descriptions below titles

Example with All Options

Sequel.renderEventGrid({
companyId: 'your-company-id-here',
darkMode: true,
excludeText: 'test',
showDescription: true
});

Examples

Basic Light Mode Grid

<div id="sequel_root"></div> 
<script type="module" src="https://prod-assets.sequelvideo.com/uploads/toolkit/sequel.js"></script>
<script>
document.addEventListener('DOMContentLoaded', (event) => {
Sequel.renderEventGrid({
companyId: 'abc123-def456-ghi789'
});
});
</script>

Dark Mode with Descriptions

<div id="sequel_root"></div>
<script type="module" src="https://prod-assets.sequelvideo.com/uploads/toolkit/sequel.js"></script>
<script>
document.addEventListener('DOMContentLoaded', (event) => {
Sequel.renderEventGrid({
companyId: 'abc123-def456-ghi789',
darkMode: true,
showDescription: true
});
});
</script>

Exclude Test Events

<div id="sequel_root"></div>
<script type="module" src="https://prod-assets.sequelvideo.com/uploads/toolkit/sequel.js"></script>
<script>
document.addEventListener('DOMContentLoaded', (event) => {
Sequel.renderEventGrid({
companyId: 'abc123-def456-ghi789',
excludeText: 'test' // Hides events starting with "test"
});
});
</script>

Event Types & Button Behavior

The widget automatically determines button text based on event type:

Event Type

Button Text

Description

Upcoming Events

"View now"

Directs to registration/event page

Past Events

"Watch now"

Directs to replay/recorded content

Styling

Built-in Themes

Light Mode (Default)

  • Clean white cards with subtle borders

  • Black buttons with white text

  • Optimized for light backgrounds

Dark Mode

  • Dark gray cards with light borders

  • White buttons with black text

  • Optimized for dark backgrounds

Custom CSS

The widget renders inside a Shadow DOM, so global CSS won't affect it. However, you can style the container:

#sequel_root { max-width: 1200px; margin: 0 auto; padding: 20px; }

Responsive Design

The widget is fully responsive and will adapt to container width:

  • Desktop: 3-column grid (1280px max-width)

  • Tablet: 2-column grid

  • Mobile: 1-column grid

Features

Automatic Pagination

  • Shows 9 events per category by default

  • "Load more" buttons appear when more events are available

  • Smooth loading states and error handling

Event Information Displayed

  • Event title (max 2 lines)

  • Event description (max 2 lines, optional)

  • Date, time, and timezone

  • Event banner image (16:9 aspect ratio)

  • Live indicators

  • Action button (View now/Watch now)

Smart Filtering

  • Only shows events with valid registration URLs

  • Past events only appear if replays are available

  • Optional text-based exclusion filtering

  • Automatic categorization (upcoming vs past)

Troubleshooting

Common Issues

"Company ID is required" Error

// ❌ Missing company ID Sequel.renderEventGrid({}); 
// ✅ Correct usage Sequel.renderEventGrid({ companyId: 'your-company-id-here' });

"Element with id 'sequel_root' not found" Error

<!-- ❌ Missing container --> 
<script> Sequel.renderEventGrid({ companyId: 'abc123' }); </script>

<!-- ✅ Add container first -->
<div id="sequel_root"></div>
<script> Sequel.renderEventGrid({ companyId: 'abc123' }); </script>

No Events Appearing

  1. Verify your company ID is correct

  2. Make sure you use the DOMContentLoaded event before calling Sequel

  3. Ensure events have Sequel embed URL set

  4. For past events, verify replays are enabled

  5. Check browser console for error messages

Events Not Loading

  1. Check network connectivity

  2. Verify the Sequel API is accessible

  3. Check browser console for CORS or network errors

Getting Your Company ID

  1. Log into your Sequel dashboard

  2. Go to Any Event -> Embed → API Settings

  3. Copy the Company ID settings page

  4. The ID format is typically: 12345678-1234-1234-1234-123456789abc

Debug Mode

Enable browser developer tools to see console logs:

  • Open Developer Tools (F12)

  • Check the Console tab for error messages

  • Look for network requests to api.introvoke.com

Browser Support

The Event Grid Widget supports:

  • Chrome 88+

  • Firefox 85+

  • Safari 14+

  • Edge 88+

Performance

  • Initial Load: ~50-100ms

  • Event Images: Lazy loaded and optimized

  • Bundle Size: ~45KB gzipped

  • Memory Usage: Minimal impact

Security

  • Uses HTTPS for all API requests

  • Renders in isolated Shadow DOM

  • No external dependencies beyond Sequel

  • Content is sanitized for XSS protection

Support

For technical support or questions:


Did this answer your question?