Strapi Plugin: Opening Hours

A custom field plugin for Strapi v5 that provides a rich UI for managing business opening hours, split shifts, and special/holiday schedules.

The JSON output follows Schema.org OpeningHoursSpecification conventions for SEO interoperability.

Features

• Weekly schedule with per-day open/closed toggle
• Split shifts — multiple time slots per day (e.g. lunch + dinner)
• Copy hours from one day to weekdays or all days
• Special/holiday hours with date ranges and labels
• Preview tab for read-only formatted display
• Schema.org compatible JSON structure
• Built entirely with Strapi Design System components

Installation

npm install strapi-plugin-opening-hours

Add the plugin to your Strapi config:

// config/plugins.ts
export default () => ({
  'opening-hours': {
    enabled: true,
  },
});

Rebuild your Strapi admin panel:

npm run build
npm run develop

Usage

1. Open the Content-Type Builder
2. Add a new custom field and select Opening Hours
3. Save the content type
4. The field appears in the content editor with three tabs: Regular Hours, Special Hours, and Preview

JSON Structure

{
  "regularHours": [
    {
      "dayOfWeek": "Monday",
      "isOpen": true,
      "timeSlots": [
        { "opens": "09:00", "closes": "12:00" },
        { "opens": "14:00", "closes": "18:00" }
      ]
    },
    {
      "dayOfWeek": "Sunday",
      "isOpen": false,
      "timeSlots": []
    }
  ],
  "specialHours": [
    {
      "label": "Christmas Day",
      "validFrom": "2025-12-25",
      "validThrough": "2025-12-25",
      "isOpen": false,
      "timeSlots": []
    }
  ]
}

Fields:

| Field | Type | Description | |-------|------|-------------| | dayOfWeek | string | Schema.org day name (Monday–Sunday) | | isOpen | boolean | Whether the business is open | | timeSlots | array | Time ranges; empty when closed | | opens / closes | string | HH:MM in 24-hour format | | label | string | Name for special hours entry | | validFrom / validThrough | string | ISO date (YYYY-MM-DD) |

Development

# Install dependencies
npm install

# Build the plugin
npm run build

# Watch mode (rebuilds on changes)
npm run watch

# Run tests
npm test

# Run tests in watch mode
npm run test:watch

Local development with a Strapi project

Link the plugin for local testing:

# In the plugin directory
npm link

# In your Strapi project
npm link strapi-plugin-opening-hours

Add the plugin with an explicit resolve path in config/plugins.ts:

export default () => ({
  'opening-hours': {
    enabled: true,
    resolve: './node_modules/strapi-plugin-opening-hours',
  },
});

Requirements

• Strapi v5
• Node.js 18+

License

MIT