Add recurrence

Author: maud-lv

articles/azure-app-configuration/howto-timewindow-filter.md

@@ -1,45 +1,56 @@
 ---
 title: Enable features on a schedule
 titleSuffix: Azure App Configuration
-description: Learn how to enable feature flags on a schedule.
+description: Learn how to enable feature flags on a schedule using time window filters in Azure App Configuration.
 ms.service: azure-app-configuration
 ms.devlang: csharp
 author: zhiyuanliang-ms
 ms.author: zhiyuanliang
 ms.topic: how-to
-ms.date: 03/26/2024
+ms.date: 10/31/2024
+#customer intent: As an application developer, I want to enable a recurring time window filter in a feature flag so that I can enable or disable features on a schedule.
 ---
 
-# Tutorial: Enable features on a schedule
+# Enable features on a schedule
 
 [Feature filters](./howto-feature-filters.md#what-is-a-feature-filter) allow a feature flag to be enabled or disabled conditionally. The time window filter is one of the feature management library's built-in feature filters. It allows you to turn on or off a feature on a schedule. For example, when you have a new product announcement, you can use it to unveil a feature automatically at a planned time. You can also use it to discontinue a promotional discount as scheduled after the marketing campaign ends.
 
-In this article, you will learn how to add and configure a time window filter for your feature flags.
+In this article, you learn how to add and configure a time window filter for your feature flags.
 
 ## Add a time window filter
 
-1. Create a feature flag named *Beta* in your App Configuration store and open to edit it. For more information about how to add and edit a feature flag, see [Manage feature flags](./manage-feature-flags.md).
+1. Create a feature flag named *Beta* in the **Feature Manager** menu of your App Configuration store and move to the right end of the feature flag you want to modify, then select the **More actions** ellipsis (**...**) action and **Edit**. For more information about how to add and edit a feature flag, see [Manage feature flags](./manage-feature-flags.md).
 
-1. In the **Edit feature flag** pane that opens, check the **Enable feature flag** checkbox if it isn't already enabled. Then check the **Use feature filter** checkbox and select **Create**.
+1. In the **Edit** pane that opens, check the **Enable feature flag** checkbox if it isn't already enabled. Then check the **Use feature filter** checkbox and select **Create**.
 
-    > [!div class="mx-imgBorder"]
-    > ![Screenshot of the Azure portal, filling out the form 'Edit feature flag'.](./media/feature-filters/edit-a-feature-flag.png)
+    :::image type="content" source="media/feature-filters/edit-a-feature-flag.png" alt-text="Screenshot of the Azure portal showing how to edit a feature flag.":::
 
 1. The pane **Create a new filter** opens. Under **Filter type**, select the **Time window filter** in the dropdown.
 
-    > [!div class="mx-imgBorder"]
-    > ![Screenshot of the Azure portal, creating a new time window filter.](./media/feature-filters/add-timewindow-filter.png)
+    :::image type="content" source="media/feature-filters/add-timewindow-filter.png" alt-text="Screenshot of the Azure portal showing time window feature filter configuration.":::
 
-1. A time window filter includes two parameters: start and expiry date. Set the **Start date** to **Custom** and select a time a few minutes ahead of your current time. Set the **Expiry date** to **Never**. In this example, you schedule the *Beta* feature to be enabled automatically at a future time, and it will never be disabled once enabled.
+1. A time window filter includes a start time and/or an end time. The start time indicates when the feature flag is activated, and the end time indicates when the flag is deactivated. Both **Start time** and **End time** checkboxes are checked by default. Enter a start time a few minutes ahead of your current time and enter an end time.
 
-1. Select **Add** to save the configuration of the time window filter and return to the **Edit feature flag** screen.
+    > [!TIP]
+    > If you don't want the feature flag to automatically deactivate, uncheck the **End time** box and it will never be disabled.
+
+1. A time zone is selected by default, based on your browser's current time zone. Optionally select another time zone.
+
+1. Select the **Enable recurrence** checkbox to set up a recurring schedule for the feature flag. This allows you to automate the activation and deactivation of the feature flag based on a specified pattern. Choose a daily or weekly frequency, the specific days, and the expiration time.
+
+    > [!NOTE]
+    > Both start time and end time must be set when recurrence is enabled.
 
-1. The time window filter is now listed in the feature flag details. Select **Apply** to save the feature flag.
+    > [!TIP]
+    > Use the recurrence feature to manage feature flags that need to be enabled or disabled on a regular schedule, such as during periods of low or high traffic.
+
+    :::image type="content" source="media/feature-filters/add-timewindow-filter-recurrence.png" alt-text="Screenshot of the Azure portal showing feature filter recurrence.":::
+
+1. Select **Add** to save the configuration of the time window filter and return to the **Edit feature flag** screen.
 
-    > [!div class="mx-imgBorder"]
-    > ![Screenshot of the Azure portal, applying new time window filter.](./media/feature-filters/feature-flag-edit-apply-timewindow-filter.png)
+1. The time window filter is now listed in the feature filter details, under **Feature filters**. Select **Apply** to save the feature flag with the new feature filter.
 
-Now, you successfully added a time window filter to a feature flag. Follow the instructions in the [Next Steps](#next-steps) section to learn how it works in your application for the language or platform you are using.
+For more information about the time window feature filter, refer to the [Microsoft.TimeWindow feature reference](/azure/azure-app-configuration/feature-management-dotnet-reference?pivots=stable-version).
 
 ## Next steps