Installation & Requirements

Keyboard shortcuts
  • JNext lesson
  • KPrevious lesson
  • /Search lessons
  • EscClear search

System requirements

Before installing GT Link Manager, confirm your environment meets these minimums.

WordPress version 6.4 or higher is required. The plugin uses rewrite rule APIs and block editor APIs that aren’t available in older versions.

PHP 8.2 or higher is required. The plugin uses strict type declarations and PHP 8.x features throughout. It will not activate on older PHP versions.

MySQL 5.7 or higher (or MariaDB 10.3+) is recommended. The plugin creates custom database tables with indexes that depend on InnoDB and standard UTF8MB4 collation support.

Browser requirements apply only to the admin interface. The block editor integration requires a modern browser. Internet Explorer is not supported.

Installing the plugin

GT Link Manager is distributed as a standard WordPress plugin ZIP file. You get it by purchasing and downloading it from gauravtiwari.org.

Via the WordPress admin:

Go to Plugins → Add New Plugin → Upload Plugin. Choose the ZIP file and click Install Now. After installation completes, click Activate Plugin.

Via FTP or file manager:

Extract the ZIP file on your computer, then upload the extracted gt-links folder to your server’s wp-content/plugins/ directory. Once uploaded, go to Plugins in your WordPress admin and activate GT Link Manager from the list.

What happens on activation

When you activate the plugin, the activator class runs a setup routine:

First, it creates two custom database tables — wp_gt_links and wp_gt_link_categories — using dbDelta() to handle both fresh installs and upgrades without dropping data.

Second, it registers the rewrite rules needed for the redirect system to function and flushes the WordPress permalink cache. This step is important — if it’s skipped for any reason, your redirect URLs won’t resolve until you manually flush permalinks from Settings → Permalinks.

Third, it stores the initial default settings if they don’t already exist.

After activation

Once the plugin is active, a new menu item called GT Links appears in the WordPress admin sidebar at position 26 (between Comments and Appearance by default).

The first thing you should do is enter your license key. Go to GT Links → License and paste your key. Without an active license, the plugin still works, but you won’t receive automatic updates. See the Licensing chapter for full details.

The second thing you should do is check your base prefix. Go to GT Links → Settings. The prefix defaults to go, so your links will be at yoursite.com/go/slug. If you want a different prefix — out, link, r, anything — change it here and save. After changing the prefix, click the Flush Permalinks button on the settings page to regenerate the rewrite rules.

Deactivation and uninstall

Deactivating the plugin (without uninstalling) leaves all your data intact. The database tables and options remain. Redirect URLs will stop resolving while the plugin is inactive, but everything is preserved for when you reactivate.

Uninstalling the plugin (via Plugins → Delete) runs the uninstall routine in uninstall.php. This drops both custom database tables and removes all plugin options from wp_options. This is permanent and cannot be undone. Export your links as CSV before uninstalling if you want to keep a backup.

Conflicts and compatibility

GT Link Manager does not use WordPress custom post types, taxonomies, or post meta. It operates entirely on its own tables. This means it’s unlikely to conflict with other plugins that manage posts or taxonomies.

The one area where conflicts can occur is the redirect prefix. If another plugin or theme already uses the go prefix as a route, you’ll get a conflict. Change your prefix in GT Link Manager settings to something unique.

If you’re migrating from another link management plugin (such as Pretty Links or LinkCentral), you can import your existing links via CSV. See the Import & Export chapter for instructions on the available import presets.