Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/pimedia/pi-giveaways/archive/refs/heads/main.zipPI Giveaways — WordPress Plugin

Create giveaways, collect moderated entries, and manually award one or more winners through a focused, privacy-aware workflow.
→ Install from WordPress.org: wordpress.org/plugins/pi-giveaways/
Description
PI Giveaways provides a complete WordPress giveaway workflow without random or automatic winner selection. Build reusable entry forms, publish current and past giveaway listings, moderate submissions, export entries, and deliberately award the configured number of winners.
Giveaways remain published after closing while their entry forms close automatically. Entry data is retained indefinitely by default unless an administrator explicitly enables scheduled retention.
Features
Giveaways and listings
- Dedicated giveaway post type with prize, value, start date, end date, and event link
- Configurable number of winners for each giveaway
- Current and past listing sections with editable headings
- Grid, list, and masonry listing layouts
- Plugin-managed listing page or shortcode-based placement
- Responsive design controls and live previews
Forms and entries
- Reusable default form with per-giveaway overrides
- First name, last name, email, phone, and terms fields
- Show, hide, require, and reorder built-in fields
- Additional custom fields and one- or two-column layouts
- One entry per email per giveaway by default
- Entry timestamps, moderation, deletion, and CSV export
- Participant and administrator email templates using WordPress
wp_mail()
Privacy and security
- Honeypot spam protection
- Optional Google reCAPTCHA v3 with a configuration test
- Nonces, capability checks, input sanitization, and late output escaping
- No Composer dependency or external email service requirement
- Entries are not automatically deleted unless retention is explicitly enabled
Installation
Via WordPress.org (recommended)
- Search for PI Giveaways in Plugins → Add New.
- Install and activate the plugin.
- Open PI Giveaways → Settings to configure the listing page, form, design, privacy, security, and email options.
- Open PI Giveaways → Add New to publish your first giveaway.
Manual
- Download the plugin from WordPress.org.
- Upload the
pi-giveawaysfolder to/wp-content/plugins/. - Activate PI Giveaways from the Plugins screen.
Shortcodes
Display the configured current and/or past giveaway listing:
[pigiveaways_giveaways]
Display one complete giveaway by post ID:
[pigiveaways_giveaway id="123"]
Display only the centered giveaway entry-form card:
[pigiveaways_form id="123"]
Replace 123 with the giveaway post ID. The listing shortcode uses the layout and visibility options saved under PI Giveaways → Settings → Design.
Screenshots
| Giveaway settings | Form builder | Listing design |
|---|---|---|
![]() |
![]() |
![]() |
| Privacy and reCAPTCHA | Email templates |
|---|---|
![]() |
![]() |
Requirements
| Minimum | Tested up to | |
|---|---|---|
| WordPress | 6.2 | 7.1 |
| PHP | 7.4 | 8.x |
Changelog
1.0.7 — 2026-10-23
- Added extension hooks for eligibility-aware winner confirmation workflows.
- Added configurable multiple-winner limits with manual enforcement and progress reporting.
- Added a post-award notification hook for extensions.
The complete release history is available in readme.txt.
Links
| 🔌 WordPress.org | wordpress.org/plugins/pi-giveaways/ |
| 💬 Support forum | wordpress.org/support/plugin/pi-giveaways/ |
| 🌐 Developer site | parorrey.com |
| ❤️ Donate | parorrey.com/donate |
Author
Ali Qureshi · PI Media · Lahore, Pakistan
WordPress Plugin & Full Stack Developer
License
PI Giveaways is licensed under the GNU General Public License v2 or later.




