REFERENCE

Plugin Documentation

A guide to the shortcodes, settings and features of GS WhatsApp Group Submitter, in both the Free plugin and the Pro Add-on.

1. Shortcodes

GS WhatsApp Group Submitter gives you four shortcodes. Add them to any page or post.

Submission form

Shows the form where visitors submit a WhatsApp group or channel link. It is also available as a Gutenberg block.

SHORTCODE

		
Group Submitter

Submit WhatsApp Group or Channel

Directory listing

Shows the groups in a responsive grid or list, with a category filter and live search.

SHORTCODE

		
📭

No groups found. Be the first to submit one!

Tables inside posts and pages

Show WhatsApp groups in a responsive table in the middle of any blog post or page.

SHORTCODE

								

SHORTCODE

								

2. Submission Form

In the Free plugin, the form has two fields:

  • WhatsApp group or channel link (the invite link)
  • Category (a dropdown of your categories)

As soon as the visitor pastes the invite link, the plugin fetches the group or channel title and its icon from WhatsApp, so nobody has to type them.

To stop spam bots, the plugin limits how many submissions one IP address can send per hour.

Pro: you can also turn on Submitter Name and Submitter Email fields and make them required, protect the form with Google reCAPTCHA, and upload your own form logo.

3. Directory Listing

The directory shows your groups in a responsive grid or list. Visitors can:

  • Filter groups by category
  • Search groups by name with live search
  • Click Join Now to open the group

In the Free plugin, Join Now opens WhatsApp directly in a new tab. With the Pro Add-on, it opens the group’s own page first (see section 6).

With Pro you can also pin sponsor or VIP groups to the top of the directory, with a 📌 Featured badge.

4. Categories

Categories are hierarchical, so you can create parent and child categories in the WordPress dashboard.

  • Add your categories from the plugin’s category screen in the dashboard
  • Visitors choose a category when they submit a group
  • The directory uses categories for its filter buttons
  • lists the groups of a category

5. Managing Groups

The Manage Groups table in the admin shows every submitted group. From there you can:

  • See each group’s status
  • Edit or delete a group
  • See the total number of clicks for each group

You will also find a Settings shortcut next to the plugin on the WordPress Plugins page.

Pro adds:

  • Sort groups by Total Clicks or by Reports, and a quick filter for Today’s Submissions
  • A 🔗 View Page link under each group
  • Add a group directly from the admin, without using the front-end form
  • CSV import and export, to move thousands of groups in one click

6. Group Pages (Pro)

The Pro Add-on gives every group and channel its own SEO-friendly page. The address uses the WhatsApp invite code, for example yoursite.com/invite-code/.

Each page includes:

  • QR code for joining the group, with a download button
  • Like and dislike voting
  • Star rating from visitors
  • Report option for inactive or spam groups
  • More in Category: related groups from the same category

In the directory, the Join Now button opens this page first, and visitors join from there.

7. Settings & Protection (Pro)

Approval control. In General Settings, turn Auto-Approve Submissions on or off. When it is off, new submissions wait in Pending Review until you approve them.

Google reCAPTCHA. Protect the form with reCAPTCHA v2 (checkbox) or v3 (invisible).

Spam keyword blacklist. Add banned words. If a group title contains one of them, the submission is rejected automatically.

Branding tab. Choose the primary accent, background, card and text colors with a live preview, and upload your own form logo.

8. License & Free Trial

The Pro Add-on works together with the Free plugin, so install and activate the Free plugin first.

Activate Pro with your license key. The key is verified with our license server. The license system also includes a 3-day free trial.

Need help getting started?

Follow the installation guide to set up the plugin, or contact support if you get stuck.