> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devdeia.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuration

> Every option in config/filament-recurrence.php.

Publish the config file first — see [Installation](/filament/recurrence/installation).

```php config/filament-recurrence.php theme={null}
return [
    // Default timezone for recurrence calculations when a record doesn't specify one.
    // Should match your application's timezone.
    'timezone' => 'UTC',

    // Default date format for displaying recurrence dates.
    'date_format' => 'Y-m-d',

    // Default time format for displaying recurrence times.
    'time_format' => 'H:i',

    // PHP date format for start/end dates in the recurrence preview sentence
    // (the human-readable description). Uses Carbon; prefer patterns without time.
    'preview_date_format' => 'j F Y',

    // Maximum number of occurrences to show in previews.
    'max_preview_occurrences' => 10,

    // Number of month grids shown in the calendar preview modal. The package
    // loads enough occurrences to cover from the start date through the end
    // of the last displayed month.
    'calendar_preview_month_count' => 2,

    // Frequencies available in the form field.
    'frequencies' => [
        'DAILY' => 'Daily',
        'WEEKLY' => 'Weekly',
        'MONTHLY' => 'Monthly',
        'YEARLY' => 'Yearly',
    ],

    // First day of the week (0 = Sunday, 1 = Monday, etc.)
    'week_start_day' => 1,

    // Whether advanced recurrence options are shown by default.
    'enable_advanced_options' => true,
];
```

<Note>
  `timezone` is the **default** used for new recurrence records and for data that doesn't have a stored timezone. Each record can override it with the form field's Timezone select — the chosen identifier (e.g. `Europe/Berlin`) is persisted in the recurrence JSON alongside the other fields. Hide that select entirely with `RecurrenceField::make('recurrence')->showTimezone(false)`, which forces every record to use the config value.
</Note>