Notification Routing Importer for Gravity Forms WP Registry grade A. No security issues foundWP RegistryNo security issues foundOpen the reportA

Bulk import notification routing rules into Gravity Forms from CSV, XLSX files or Google Sheets.

Import

• Upload a CSV or XLSX file to populate notification routing rules in bulk
• Smart field mapping: reference form fields by their label (e.g., Department) or explicitly by ID (e.g., {:5})
• Flexible column order: columns are matched by header name, not position
• Replace or Append: choose whether imported rules overwrite existing routing rules or are added alongside them
• Auto-detect CSV separator: comma (,) and semicolon (;) are both supported

CSV / XLSX Format

Your file must contain a header row with these column names (case-insensitive, any order):

Column Details

Field ID Resolution

The field column supports two modes:

• By label: write the field label exactly as it appears in the form editor (case-insensitive match)
  • Example: Department, First name, Zip code
• By explicit ID: wrap the numeric ID in {:…}
  • Example: {:5}, {:12}

A bare number (e.g., 5) is also accepted and treated as a field ID.

Key Features

• Multilingual: Works with content in any language
• Translation-Ready: All strings are internationalized
• Secure: Capability checks, nonce verification, file MIME validation, and XXE protection for XLSX files
• GitHub Updates: Automatic updates from GitHub releases

Google Sheets Integration

Requires the GC Google Sheets plugin by GravityWiz.

You can connect a Google Sheet as a live source for routing rules. Once connected, the plugin can keep your notification routing automatically in sync without any manual intervention.

Setup

1. In GC Google Sheets, connect at least one Google account (GravityWiz → Google Sheets → Accounts).
2. Edit a Gravity Forms notification and select Configure Routing under "Send To".
3. In the Import Routing Rules panel, switch to the Google Sheets tab.
4. Select your Google Account, paste the Spreadsheet URL, then click Load Sheets and pick the correct Sheet Tab.
5. Click Import from Google Sheets to do a one-time import and verify the rules look correct.
6. Choose an Auto-sync interval (see below), then click Update Notification to save.

Spreadsheet Format

The sheet must follow the same four-column format as CSV/XLSX files — the header row can appear in any order:

Column names are case-insensitive. See Column Details for accepted aliases and operator values.

Auto-sync

Once saved, the plugin can update routing rules automatically whenever the sheet changes:

The sync runs via WP-Cron. If WP-Cron is disabled or loopback HTTP requests are unavailable in your environment (common with Docker or server-side cron setups), the plugin automatically falls back to running the sync on the next admin page load instead.

The last sync time and status (success or error) are displayed below the Auto-sync dropdown.

Note: The notification routing rules are updated silently in the background. Gravity Forms does not need to be re-saved — the routing saved in the database is updated directly.

Removing the Connection

To disconnect a Google Sheet, switch back to the File Upload tab before saving the notification. The connection and its auto-sync schedule are cleared automatically.

Requirements

• WordPress 5.8 or higher
• PHP 7.4 or higher
• Gravity Forms 2.5 or higher
• PHP ZipArchive extension (for XLSX support — typically available on most hosts)

Installation

1. Upload the gf-notification-routing-importer folder to /wp-content/plugins/
2. Activate the plugin through the Plugins menu in WordPress
3. Navigate to Forms → [Your Form] → Settings → Notifications → Edit a notification
4. Select Configure Routing under "Send To" — the import button appears below the routing rules

FAQ

Where does the import button appear?

The import button is injected directly into the notification edit page, below the routing rules, when Configure Routing is selected as the "Send To" option.

What happens if a field label doesn't match any form field?

The row is skipped and a warning is displayed after import. Other valid rows are still processed.

Can I import merge tags as email addresses?

Yes. GF merge tags like {admin_email} are supported in the email column.

Does the plugin modify the notification automatically?

No. After import, the routing rules appear in the standard GF routing UI. You still need to click Update Notification to save.

What happens if my CSV uses semicolons?

The plugin auto-detects whether your CSV uses , or ; as the separator.

Project Structure

.
├── .github
│   └── workflows
│       └── release.yml                   # GitHub Actions release workflow
├── gf-notification-routing-importer.php  # Main plugin file
├── uninstall.php                         # Cleanup on uninstall
├── README.md
├── assets
│   ├── css
│   │   └── admin.css                     # Import/Export UI styling
│   ├── js
│   │   └── admin.js                      # Import/Export UI logic
│   └── sample-routing-import.csv         # Downloadable sample file
├── includes
│   ├── class-github-updater.php          # GitHub auto-updates
│   ├── class-import-handler.php          # AJAX handler & CSV parsing
│   ├── class-xlsx-parser.php             # XLSX parser (ZipArchive)
│   └── Parsedown.php                     # Markdown parser (for View details)
└── languages
    ├── gf-notification-routing-importer.pot        # Translation template
    └── gf-notification-routing-importer-fr_FR.po   # French translation

Changelog

1.1.0

• Google Sheets integration: use a Google Sheet as a routing source (requires GC Google Sheets by GravityWiz)
• Auto-sync: automatically update routing rules from Google Sheets on a configurable interval (5 min / 15 min / 30 min / 1 hour)
• Persistent Google Sheets connection: settings are saved with the notification
• Admin-init fallback for environments where WP-Cron does not fire

1.0.0

• Initial release
• CSV and XLSX bulk import for notification routing rules
• CSV export of existing routing rules
• Drag-and-drop file upload
• Smart field ID resolution by label or explicit {:ID} syntax
• Human-friendly operator aliases (less than, greater than, is not, etc.)
• Non-routable field type validation (page, section, html, captcha)
• Flexible column detection by header name
• Replace/Append toggle
• Auto-detect CSV separator
• Downloadable sample CSV
• GitHub auto-updater with release workflow
• Bug Reporter integration
• Full security: capability checks, nonce verification, file validation, XXE protection

License

This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0) - see the LICENSE file for details.

Made with love for the WordPress community