Complementor/ACF number progress
Content / widget · Elementor module

ACF Number Progress Bar Plugin for Elementor

Show a saved ACF Number field as a progress bar against a fixed target or another ACF Number field, with value text and native styling.

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

Saved ACF numbers shown as progress bars

These are actual published outputs of the widget on a lane page whose ACF Number fields hold sample site data: a 0-100 completion figure with the default settings, money raised against a goal field, a styled bar with an icon and the value above it, and an over-target value whose bar is clamped while the text keeps the real number.

02 / Inside WordPress

ACF number progress controls in Elementor

Content has three sections. Source picks the ACF Number field that holds the value. Behaviour sets the target (a fixed number or another Number field) and what happens when there is no usable target or the value is negative or over the target. Display sets the label, progress name, optional icon, the value/percentage format and decimals. The Style tab has Label & value (typography, colours, surface, spacing, value position and value typography), Icon and Bar (track and fill colours, width, height, radius and track border).

03 / Website use cases

Where to use acf number progress

Fundraisers, build projects and ticketed events keep their current figure in an ACF Number field, but Elementor's Progress Bar needs a percentage typed by hand. ACF number progress reads the saved value on the current post, compares it with a fixed goal or another Number field, and shows the bar, the real numbers and the percentage.

01

Fundraising and donation pages

Store the amount raised and the goal in two ACF Number fields and show '6,450 of 10,000 (65%)' with a bar that updates when an editor saves new figures.

02

Project and build status pages

Keep a 0-100 completion figure on each project page and display it as a labelled progress bar in a shared Elementor layout.

03

Event capacity and ticket sales

Compare tickets sold with a fixed capacity; if sales pass the capacity, the bar stays full while the text shows the real number and percentage.

04 / Installation and setup

How to show an ACF number as a progress bar in Elementor

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

  1. Install Advanced Custom Fields and Complementor, then enable ACF number progress in the Complementor library in WordPress.

  2. Create ACF Number fields for the value (and, if you want, the goal) with location rules that include the page or post, and save values on that post.

  3. Edit that post with Elementor, add the ACF number progress widget and choose the value field in Content › Source.

  4. In Behaviour, choose a fixed target number or another ACF Number field, and decide what happens with a missing target or an out-of-range value. In Display, set the label and the value, percentage or both format.

  5. Style the label, value text, icon and bar in the Style tab, then publish and check the page at mobile width.

05 / Content and style controls

Customize acf number progress in Elementor

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

  • Source: one top-level ACF Number field on the current post, picked from the fields its field group location rules attach to that post.

  • Target: a fixed number (100 by default) or another ACF Number field on the same post, such as a stored fundraising goal.

  • Fallbacks: with no usable target (unsaved, zero or negative) show the value without a bar or hide the widget; for a negative or over-target value clamp the bar while keeping the real numbers, or hide the widget.

  • Display: optional visible label and accessible progress name, an optional icon, and value of target, percentage only or both, with editable "of" text, percentage suffix and value and percentage decimals.

  • Label & value styling: typography and text colour, background, border, radius and padding, responsive alignment and spacing, value position above or below the bar, and separate value typography and colour.

  • Bar styling: track and fill colours, responsive width, height and corner radius, a track border you can change or remove, plus icon position, size, gap and colour.

06 / Choose the right approach

ACF number progress and Elementor alternatives

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

Elementor Progress Bar widget

Elementor's free Progress Bar widget shows a percentage you enter in the editor. Prefer it when the percentage is fixed content; use ACF number progress when the figures live in ACF fields and the percentage should be calculated from a value and a target.

Elementor Pro ACF dynamic tag in a Heading or Text Editor

With Elementor Pro you can print an ACF Number field in any text widget using the ACF Field dynamic tag. Prefer it when you only need the number; it does not compare the value with a goal or draw a bar.

Elementor Counter widget

The Counter widget animates up to a number you enter. Prefer it for headline statistics; it has no target, percentage or progress semantics.

07 / Requirements and compatibility

ACF number progress compatibility with Elementor

WordPress 6.5+PHP 8.0+Elementor 3.25+
  • Requires Elementor and Advanced Custom Fields (free or Pro); Elementor Pro and WooCommerce are not required.
  • Reads top-level ACF Number fields saved on the current published post or page; it does not read options pages, users, terms, or fields from another post.
  • Field pickers list fields attached to the post being edited, so a Theme Builder template that is not itself covered by the field group's location rules has no fields to choose.
  • It displays saved numbers only. It does not collect donations, count sales or update values; your editors or other plugins save the field values.

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 number progress

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

Why does the published page show nothing?

The selected Number field has no saved value on this post. ACF's default value is not used, because a default is not real data. Save a value on the post (zero counts). In the Elementor editor the widget shows a setup hint instead.

Why is the Value field list empty?

The list only shows top-level ACF Number fields whose field group location rules include the post you are editing. Check the location rules, save the post and reopen the editor. Number fields inside groups or repeaters are not listed.

Why is the bar full while the text says 108%?

The value is above the target. With the default 'Clamp the bar, keep the true number' setting the bar stops at the end of the track and the text keeps the real value and percentage. Choose 'Hide the widget' under Behaviour if you prefer to hide it.

Why does the widget show a number but no bar?

There is no usable target: the target field is not selected, has no saved value, or holds zero or a negative number. Save a positive goal, or choose 'Hide the widget' for this case under Behaviour.

09 / Frequently asked questions

ACF number progress plugin questions

Which ACF field types does ACF number progress read?

Top-level ACF Number fields only, for both the value and the optional target field. Text fields, group and repeater subfields and options-page values are not used.

Does it need Elementor Pro?

No. It works with Elementor and the free version of Advanced Custom Fields. It reads the fields of the post being viewed, so it does not need Pro dynamic tags.

Can the target come from another field?

Yes. Set Target to 'Another ACF number field' and pick the field that stores the goal. You can also enter a fixed target number instead.

Is the progress bar accessible?

When a target is known it renders a progressbar role with a name, minimum, maximum and value text that matches the visible text. Without a target it renders plain text only, so it never claims a range it does not have.

Does the bar animate?

No. The bar is drawn at its final width with no animation or script, so it shows the same result for every visitor and needs no motion settings.

10 / Annual All Access subscription

Get acf number progress 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.