Relative Date Extension for Date Pickers

What You’ll Learn

• How to install the Relative Date Max/Min extension
• How to configure relative date expressions on date dropdown fields
• Supported expression formats and how they work
• How to handle multiple date fields in the same campaign

Overview

Digioh date dropdown fields support a static maximum and minimum selectable date, which you can set in the field editor. However, maintaining those static dates requires manual updates over time. For example, a date field on a maternity brand may need its maximum date updated each year to stay accurate.

The Relative Date Max/Min extension lets you set a relative date expression directly on the field using metadata. Instead of entering a fixed date like 12/31/2028, you configure a value like =2y and the extension automatically calculates the correct date each time the campaign loads, always relative to today.

Setup

Step 1: Install the Extension

1. Log in to your Digioh account and click your name in the top-right corner.
2. Select Extensions from the dropdown menu.
   
3. On the Extensions page, go to the Miscellaneous section and install the Relative Date Max/Min extension
   

5. Click Publish to Your Site to activate the extension across your account.

Step 2: Configure Metadata on Your Date Field

To set a rolling date limit on a date dropdown field, you need to add metadata directly to that field in the campaign editor. Metadata must be added at the field level, not at the campaign or page level.

1. Open your campaign in the Digioh editor.
2. Navigate to the page that contains your date dropdown field.
3. Click the Form tab, then select your date field.
4. Scroll down to the Field Metadata section.
5. Add one or both of the following keys:

Metadata Key	What It Does	Example Value
max_date	Sets how far into the future a user can select	=1y
min_date	Sets how far into the past a user can select	=1d

For example: 

In this example, the field is configured for a due date question. Setting max_date to =9m limits the dropdown to dates up to 9 months from today, and setting min_date to =1d ensures yesterday and earlier are not selectable. Together, they keep the available date range accurate for an expected due date.

Date Expression Format

Values follow a simple format: an equals sign, a number, and a unit. The supported units are y for years, m for months, and d for days. For example:

• =9m limits selection to 9 months from today
• =100y limits selection to 100 years from today
• =30d limits selection to 30 days from today
• =0d limits selection to today (useful as a max to prevent future dates)

You do not need to use a negative sign for min_date. The direction is determined by the metadata key itself.

Multiple Date Fields

The extension fully supports multiple date dropdown fields on the same campaign page or across different pages. Each field is configured and managed independently using its own metadata.

Same Page

Each date field on the same page is handled separately. The metadata you set on one field has no effect on any other field on the page.

Different Pages

Fields on different campaign pages are also supported. All fields across all pages are picked up when the campaign loads, so you can configure date limits on any page without any additional steps.

Troubleshooting

If the extension is not behaving as expected, the Digioh Diagnostics panel in campaign preview is the best place to start. It shows confirmation messages when the extension runs successfully, and warning messages when something is misconfigured.

Using the Diagnostics Panel

When previewing your campaign, the Digioh Diagnostics panel is available in the bottom-left corner of the page. Click on Relative Date Max/Min to expand it and view confirmation messages showing that the extension ran and applied the date limits correctly.

Warning Message	Cause	Fix
Invalid max_date expression "=2x"	Unsupported unit or missing = prefix	Use only y, m, or d as units and always prefix with =. For example: =2y
Date dropdown not found for main_custom_1	The field metadata is configured but the field does not exist or is not a date dropdown	Confirm the field is enabled and set to type Date Picker (dropdown) in the editor
Invalid range: min year (2031) is greater than max year (2026)	The min_date expression resolves to a year later than max_date	Check both expressions. min_date goes backward, max_date goes forward
max_date must be set at field level, found at: page	Metadata was added at the wrong level	Move the metadata to the field level: Editor > Page > Form > Fields > Field > Metadata
max_date/min_date only valid on datedrop fields, found field_type: text	Metadata applied to a non-date field	Only add max_date or min_date metadata to fields configured as Date Picker (dropdown)

Related Resources

• How to Configure Metadata in Digioh
• Digioh Date Picker Field Setup