Complementor/ACF date range
Content / widget · Elementor module

ACF Date Range Plugin for Elementor

Show two saved ACF Date Picker or Date Time Picker fields as one readable date range, with same-day, missing-end and date format options.

Included in All AccessClassic Elementor widgetFrom $29 USD / year
Complementor / ACF date rangeProduct preview
Text, style and layout controls inside Elementor
01 / Interactive demonstration

Real date ranges from saved ACF fields

These are the actual published outputs of the widget reading sample ACF values saved on the demo page: a two-day Date Picker range, a same-day Date Time Picker workshop, a custom format with icon and native styling, an end field with no saved value, and a start field with no saved value.

02 / Inside WordPress

ACF date range controls in Elementor

Content has three sections. Source picks the start field and an optional end field from the ACF Date Picker and Date Time Picker fields assigned to the post. Behaviour sets same-day handling, what happens without an end date, and the separator. Display chooses the site format or a custom PHP date format and an optional icon. The Style tab has a Date range section (typography, text colour, alignment, background, border, corner radius, padding) and an Icon section (colour, position, size, gap).

03 / Website use cases

Where to use acf date range

Event, course and project pages often keep a start date and an end date in Advanced Custom Fields. Showing them in Elementor usually means two separate dynamic values, a hand-typed dash and an odd result for one-day events. ACF date range reads both saved fields and prints one readable range.

01

Conference and event pages

Show a multi-day event as one range such as November 12, 2026 – November 14, 2026 from two Date Picker fields.

02

Workshops and classes

Show a one-day session with Date Time Picker fields as one date followed by its start and end time.

03

Exhibitions, projects and offers

Show when an exhibition runs, when a project took place or until when an offer is valid, and simply show the start date while the end is not decided.

04 / Installation and setup

How to show an ACF date range in Elementor

Start with Complementor installed and your license connected. Enable this module in the WordPress library, then configure it in Elementor.

  1. Activate Advanced Custom Fields and Complementor, then enable ACF date range in the Complementor library in WordPress.

  2. In ACF, add a field group with a Date Picker or Date Time Picker field for the start and one for the end, assign it to your post type and save dates on each post.

  3. Open the post in Elementor and drag in the ACF date range widget. In an Elementor Pro single template, first set Preview Settings to a post that has these fields.

  4. In Content, choose the start and end fields under Source, set same-day handling, the no-end-date rule and the separator under Behaviour, and pick the date format and optional icon under Display.

  5. Style the range in the Style tab using the Date range and Icon sections, then publish and check both a one-day and a multi-day post.

05 / Content and style controls

Customize acf date range in Elementor

Configure the settings available for this module to suit the page you are building.

  • Start and end field pickers that list only the top-level ACF Date Picker and Date Time Picker fields assigned to the post being edited.

  • Same-day ranges either show the date once (keeping both times for Date Time Picker fields) or show the start and end separately.

  • When the end date is missing, show the start date only or hide the widget; a missing start date always hides it on the published page.

  • An editable separator between the two dates, an en dash by default.

  • Site date and time formats from WordPress settings, or any custom PHP date format such as D j M or l j F Y.

  • Optional icon, a calendar by default, before or after the dates with responsive size and gap and its own colour.

  • Date range styling: typography, text colour, responsive alignment, background, border, corner radius and padding.

  • Each date is output in an HTML time element with a machine-readable datetime value.

06 / Choose the right approach

ACF date range and Elementor alternatives

Compare the existing Elementor workflow with this Complementor module before choosing your setup.

Elementor Pro dynamic tags with ACF fields

Elementor Pro can insert each ACF date into a Heading or Text Editor widget as a dynamic tag. Use it when you need a single date inside longer text. ACF date range combines both fields, collapses same-day ranges and handles a missing start or end date for you.

Theme template code with get_field()

A developer can print the two dates in a PHP theme template with ACF's get_field(). Prefer this when you need durations, calendars, sorting or other logic; the widget keeps the range editable in Elementor without code.

07 / Requirements and compatibility

ACF date range compatibility with Elementor

WordPress 6.5+PHP 8.0+Elementor 3.25+
  • Requires Elementor and Advanced Custom Fields (verified with the free ACF 6.8.10). Elementor Pro is needed only for Theme Builder templates.
  • Reads saved top-level Date Picker and Date Time Picker values on the current post; no options pages, repeaters, users, terms or arbitrary post IDs.
  • On the public page, only published posts without a password are read; drafts and private posts stay hidden.
  • Shows the two saved endpoints as a range; no durations, recurrence, sorting or visitor time-zone conversion.

Complementor uses classic Elementor APIs. Atomic-native controls are not implemented. Check your theme, cache and integrations on a staging site before release.

08 / Common setup problems

Troubleshoot acf date range

Check these settings if the published page behaves differently from the editor.

Why are there no fields to choose from?

Only top-level Date Picker and Date Time Picker fields whose field group location rules include this post are listed. Fields inside a Group or Repeater are not supported. After adding a field group, reopen the Elementor editor. In an Elementor Pro single template, set Preview Settings to a post that has the fields.

Why does the published page show nothing?

The start field has no saved value on this post, or the end date is missing and When there is no end date is set to Hide the widget. Drafts, private and password-protected posts are never read on the public page. In the editor the widget shows a hint explaining which case applies.

Why does a one-day event show only one date?

Same-day range is set to Show the date once by default. With two Date Time Picker fields the date is shown once with both times. Choose Show start and end separately to print both endpoints in full.

Why is the date format different from the one in my ACF field settings?

The widget formats saved dates itself, using the date and time formats from Settings › General or the custom PHP date format in the Display section. The ACF display and return formats are not used.

Why is the ACF default value not shown?

The widget reads only values that are saved on the post. Edit and update the post in WordPress so ACF stores the date.

09 / Frequently asked questions

ACF date range plugin questions

Which ACF field types does ACF date range support?

Top-level Date Picker and Date Time Picker fields saved on the current post or page. Other field types, sub-fields, options pages, users and terms are not listed.

Does it work in an Elementor Pro single template?

Yes. On the published page it reads the dates of the post being viewed. In the template editor, set Preview Settings to a post that has the fields so the pickers and preview can use them.

Which time zone are the dates shown in?

Dates are read and formatted in the site time zone from Settings › General. They are not converted to each visitor's time zone.

Does it calculate durations or countdowns?

No. It shows the saved start and end exactly as saved. It does not count days, sort reversed dates or create recurring events.

Is the date range accessible?

The range is plain text with each date in an HTML time element, and the optional icon is hidden from assistive technology. Text colour, background and typography are fully customisable in the Style tab.

10 / Annual All Access subscription

Get acf date range with Complementor

This module is included with all 1007 current Complementor solutions. Choose your production website allowance; every plan includes the same modules.

All Access · 1 site

One website

$29USD / year
  • All 1007 current modules
  • Plugin downloads and updates for one year
  • New releases during the paid term
  • Product support
Choose 1 site ↗

Renews at $29 USD each year.

All Access · 5 sites

A few websites

$49USD / year
  • All 1007 current modules
  • Plugin downloads and updates for one year
  • New releases during the paid term
  • Product support
Choose 5 sites ↗

Renews at $49 USD each year.

All Access · 25 sites

More websites

$99USD / year
  • All 1007 current modules
  • Plugin downloads and updates for one year
  • New releases during the paid term
  • Product support
Choose 25 sites ↗

Renews at $99 USD each year.

Applicable taxes extra. Annual subscriptions renew automatically unless canceled in your customer account. Elementor Pro is required for Exclude current post. Read the terms and 14-day technical-issue refund policy.