How to Set Time Constraint on Catalog

This guide explains how to configure a catalog to operate only during specific days and time ranges using Time Constraint settings in the Twirll portal.

Navigation: Operations → Manager Menu → Menu Overview

Step 1: Login & Navigate to Menu OverviewLogin to your Twirll business portal, then go to Operations → Manager Menu → Menu Overview.

Step 2: Select the CatalogFrom the list of available catalogs, click on the catalog name where you want to apply the time constraint.

Step 3: Open Catalog SettingsClick on the Catalog Settings (gear icon) to open catalog configuration options.

Step 4: Click “Time Constraint”From the settings menu, choose the Time Constraint option to open the scheduling editor.

Step 5: Add JSON SchedulePaste the following JSON into the editor box. Modify it to match your business hours for each day of the week, and add any special days as needed. Paste JSON and Save

{
  "schedule": {
    "always_on": false,
    "day_wise_schedule": [
      {
        "day": "Monday",
        "open": true,
        "open_24hours": false,
        "timings": [
          { "start": "11:30", "end": "22:00" }
        ]
      },
      {
        "day": "Tuesday",
        "open": true,
        "open_24hours": false,
        "timings": [
          { "start": "11:30", "end": "22:00" }
        ]
      },
      {
        "day": "Wednesday",
        "open": true,
        "open_24hours": false,
        "timings": [
          { "start": "11:30", "end": "22:00" }
        ]
      },
      {
        "day": "Thursday",
        "open": true,
        "open_24hours": false,
        "timings": [
          { "start": "11:30", "end": "22:00" }
        ]
      },
      {
        "day": "Friday",
        "open": false,
        "open_24hours": false,
        "timings": [
          { "start": "11:00", "end": "15:00" }
        ]
      },
      {
        "day": "Saturday",
        "open": false,
        "open_24hours": false,
        "timings": [
          { "start": "11:00", "end": "15:00" }
        ]
      },
      {
        "day": "Sunday",
        "open": false,
        "open_24hours": false,
        "timings": [
          { "start": "11:30", "end": "22:00" }
        ]
      }
    ],
    "special_days": [
      {
        "date": "2025-10-20",
        "open": true,
        "open_24hours": false,
        "timings": [
          { "start": "09:00", "end": "23:00" }
        ]
      }
    ]
  }
}

🧩 Understanding Each Field in the JSON:

“always_on”: true → Catalog always active 24/7, ignores schedule. false → Uses day-wise schedule.
“day_wise_schedule”: Specifies opening hours for each weekday.
“day”: Name of the weekday (Monday–Sunday).
“open”: true → catalog open that day; false → catalog closed.
“open_24hours”: true → catalog open all day; false → use timings array.
“timings”: Array of active time slots for that day. Multiple slots can be added if needed.
“special_days”: Exceptions like holidays or events. Specify date, open, timings.

Step 6: Save Changes

Click Save to apply the schedule. The catalog will now automatically open and close according to the configured times.

Tip: Test your catalog in online ordering or POS system to ensure the schedule is applied correctly.

Admin Portal

🧩 Understanding Each Field in the JSON: