ACF Onyx Poll


This plugin requires ADVANCED CUSTOM FIELD PRO installed.

Plugin for polls based on regular WordPress and acf (advanced custom fields) functionalities using WP REST API and Javascript methods.

The main goal of ACF Onyx Poll is to be totally free, lightweight and simple. No fancy, colorful and polluted options or donate screens.

This plugin is based on Twitter poll cards style.


Gutemberg Block with live preview
✔ Include poll with a shortcode (ommit the ID to get the latest poll) [onyx-poll id=XX class="left|right|full"]
✔ One click to vote
✔ Works with cache plugins
✔ Multiple polls per page
✔ Support for images
✔ Native widget for sidebar
✔ Multiple style options [onyx-poll class="twitter|standard"]
✔ Show poll in a modal
✔ Show poll results on widget after expired
✔ Highlight choosed choice in results area
✔ Limit vote by device or time
✔ Poll activation/expiration schedule
✔ Results in percentage, numbers or both
✔ Show/Hide results
✔ Customize css with css variables
✔ Disable all plugin CSS and use your own
✔ Custom columns on WordPress data table admin area
✔ Translations support


  • This plugin does not support Internet Explorer Browser. One of the goals of this plugin is to be js/css lightweight and jQuery free.

  • ACF Onyx Poll register fields via php to be able to use WordPress translation functions for field labels. So you won’t be able to view/edit the fields inside ACF Custom Fields Settings.

  • To enable a better/faster CRON you need to manually set your host cronjob to get https://domain.tld/wp-json/onyx/polls/cron endpoint or disable WP-Cron define('DISABLE_WP_CRON', true); inside your wp-config and manually create the cron in your host/server

    • Option 1: To run every hour set the cron:
      0 * * * * wget -q -O - https://domain.tld/wp-json/onyx/polls/cron > /dev/null 2>&1

    • Option 2: if you disable the default WP-Cron:
      0 * * * * wget -q -O - > /dev/null 2>&1


  • Admin List Screen.
  • Creating a poll.
  • Example of poll widget/modal


From your WordPress dashboard

  1. Visit Plugins > Add New
  2. Search for “ACF Onyx Poll”
  3. Activate ACF Onyx Poll from your Plugins page
  4. Click on the new menu item “Polls” and create your first Poll!


Do I need ACF PRO Installed?

Yes, Advanced Custom Fields PRO is mandatory

How to add a poll to a post?

  • If Gutenberg is active, you can use the ACF Onyx Poll Block with live preview
  • Or..use the shortcode [onyx-poll] to get the latest poll
  • To add a specific poll, assign the option ID with the requested poll to the shortcode: [onyx-poll id=XX]
  • You can align the poll container with the option class in the shortcode: [onyx-poll class=left]. Available options are left, right, full
  • Is it possible to combine style and aligment. Ex: [onyx-poll class="standard left"]

How to add a poll to a sidebar?

  • To include a widget, your theme need to support it. Go to Appereance > Widgets and select Poll widget from ACF Onyx Poll

Is it possible to use my own CSS?

Yes, go to the settings poll menu. You can do some customization by overriding some CSS variables inside your css file.

.onyx-poll {
    --pollWidgetWidth: 400px;
    --borderColor: #dbe9f5;
    --boxShadow: 0 4px 12px 6px rgba(31,70,88,0.04);
    --modalBorderRadius: 4px;
    --questionColor: #333;
    --choiceColor: #333;
    --buttonColor: #333;
    --choiceHoverBG: #f5f5f5;
    --choiceBarColor: #e0e0e0;
    --choiceBorderRadius: 100px;
    --closeBorderRadius: 100px;
    --loaderBorderColor: rgb(209, 226, 240);
    --loaderBG: #a3caec;

What kind of logs and user data this plugin saves in database?

At the database side, ACF Onyx Poll uses the default ACF/Wordpress structure to store data (the meta fields). Nothing to worry about here.

For privacy, ACF Onyx Poll does not store any user data like ip address, usernames etc…

The only things the plugin saves in the user’s browser is some cookies to check the user choice for specific poll, if the modal was previously showed/closed and a timer. You can check the cookies by looking for onyx_poll_limit_XX, onyx_poll_modal and onyx_poll_choice_XX.

What about browsers support?

All modern browsers will be fine: Chrome, Firefox, Safari and Microsoft Edge (legacy and chromium based).

This plugin will not work with any Internet Explorer version.


2023년 10월 21일
The concept of polls is so simple, yet many WP poll plugins completely fail at this in my opinion, over complicating things, bugs, bad designs, it's all over the place but generally quite bad. This plugin however does polls well. It's simple with a clean design. No bloat or bugginess. It just works and does the job well.
2022년 3월 26일
Nice and simple. Works great - I just hope it's not abandoned.
2020년 7월 10일
Very nice plugin for creating polls (making use of ACF PRO). Adding new polls is a breeze and with widgets and shortcodes they are embedded where ever you want.
모든 4 평가 읽기

기여자 & 개발자

“ACF Onyx Poll”(은)는 오픈 소스 소프트웨어입니다. 다음의 사람들이 이 플러그인에 기여하였습니다.


“ACF Onyx Poll”(이)가 1(으)로 번역되었습니다. 기여해 주셔서 번역자님께 감사드립니다.

자국어로 “ACF Onyx Poll”(을)를 번역하세요.

개발에 관심이 있으십니까?

코드 탐색하기는, SVN 저장소를 확인하시거나, 개발 기록RSS로 구독하세요.



Release Date – 29 Set 2023

  • TESTED: WordPress up to 6.3.1


Release Date – 20 Jul 2021

  • TESTED: WordPress up to 5.8

  • ADDED: Now is possible to change the poll image size in options menu

  • FIXED: Label for singular votes, thanks to @Dathix. See more in:


Release Date – 13 Jan 2021

  • FIXED: Removed an ACF hook that was causing issues with ACF JSON save location. See more in:

  • FIXED: Fatal error on list polls when ‘end date’ field was for some reason saved with an empty value. See more in:

Thanks to:
– @rampantprint (on github)
– @bwiebeck (on github)


Release Date – 21 Set 2020

  • IMPROVEMENT: Using ACF PRO as MU Plugin is now possible.


Release Date – 11 Aug 2020

  • TESTED: WordPress 5.5
  • FIXED: Rest API method permission_callback typo


Release Date – 30 May 2020

  • HOTFIX: Some filters were causing fatal errors in some themes and conflicting with certain plugins


Release Date – 30 May 2020

  • NEW Gutenberg Onyx Poll Block with live preview (no more shortcodes :))
  • Shortcode is now available to copy on the pool table list
  • Fix some php notices (again :))
  • CSS adjustments
  • JS adjustments
  • Languages updates


Release Date – 29 May 2020

  • Added native sidebar widget
  • Added new bar style
  • Update en language source pot file.
  • Fix results view bug when only numbers or percentage option is selected
  • Fix some php notices
  • Fix css flex alignment
  • Fix click event bug


Release Date – 27 May 2020

  • Initial release