FAQ

Questions, answered.

Distribution, licensing, product behavior, safety, and GitHub Sync.

Current release v1.2.69 · Changelog

Find

Search questions

No questions match. Try another keyword or pick a category above.

Distribution

Why isn’t Grafucci Code on WordPress.org?

We distribute only from grafucci.com/code so we can ship one ZIP for Free and Pro, Freemius licensing, and updates on our own cadence — without the WordPress.org review queue and directory rules that do not fit a free-plus-paid product.

That is not a trust dodge. The plugin is GPLv2. The free tier is free forever. You install from our site instead of the directory, and updates arrive through our channel after you register Free or activate a paid license.

Is there a separate Pro download?

No. There is one ZIP for free and paid use. After you purchase, enter your secret license key under Settings → License to unlock Pro features inside the same plugin.

Who can use Grafucci Code?

Anyone who can install plugins on a WordPress site. The free tier needs no license. Only administrators with manage_options can open the plugin UI and change snippets — it is not meant for lower-capability editor roles.

Is the plugin GPL?

Yes — GPLv2 or later. The free tier needs no license. Pro features require a valid paid license activated inside the same plugin binary.

Licensing

What is the difference between free and paid?

Free includes the full snippet manager, folders, locations, custom shortcodes, display conditions, Polylang pickers, up to 3 generated pages, 1 version per snippet, Tools → System tests health check, Audit Log, and safety tools. Paid unlocks GitHub Sync, Import/Export, Testing Mode, unlimited pages, up to 50 versions, and site activations. Free vs Pro · Compare plans

Is the free tier a crippled demo?

No. Free is production-usable for real sites. Upgrade when you need GitHub Sync, full history, Import/Export, Testing Mode, or more than 3 generated pages — not because the free workspace is incomplete.

What happens when my yearly license expires?

The free tier keeps working. Pro features lock when your license expires — GitHub Sync, import/export, Testing Mode, unlimited generated pages, and full version history — until you renew. You will not receive updates or support, and cannot activate new sites.

What does a lifetime license mean?

Lifetime is available on Solo, Studio, and Agency. Pay once for Pro at that plan’s site limit (1 / 5 / 25) for the life of the product. Use the Lifetime tab on Pricing. See the License Agreement.

What counts as one site activation?

One WordPress installation where you activate your license. Staging and local environments are typically handled separately through Freemius rules for your account.

How do I activate my license?

Complete Free or a paid plan on Pricing, install the ZIP from Freemius, then for paid plans open Settings → License and paste your secret key (not a pk_ public key). Licensing guide

Can I upgrade from Solo to Studio mid-year?

Yes. Upgrades are prorated through Freemius. Your key stays the same; site limits expand to the new plan.

What is your refund policy?

14-day money-back on paid licenses. Email [email protected] within 14 days of purchase.

Product

Does it work with Elementor and other page builders?

Yes. Use Auto insert for global locations (header, footer, frontend) or place snippets with the shortcode inside Elementor HTML widgets, Gutenberg blocks, or classic content. Display conditions still apply to auto-inserted snippets.

Can I migrate from WPCode or Code Snippets?

Yes on Pro. Export your library from the other plugin where possible, then use Grafucci Code Tools → Import with a JSON bundle, or recreate critical snippets manually on Free. After import, review locations and activate PHP only when you are ready in Settings → Safety.

What happens to my data if I uninstall?

By default, uninstalling removes plugin tables and options unless you have enabled a keep-data / uninstall retention setting in the plugin (when available). Always export a Pro JSON backup before uninstalling if you may return. WordPress pages created as Generated Pages remain as normal pages after disconnect or uninstall.

Does it work on multisite?

Yes. Licensing is per-site activation — each subsite that uses Pro features counts toward your plan unless Freemius treats your network install differently.

Auto insert vs Shortcode — is there a Manual mode?

No. Snippets run via Auto insert (when location rules match) or Shortcode placement. There is no separate “Manual” execution mode.

Safety

How does PHP safety work?

PHP is disabled globally until you enable it in Settings → Safety — with a one-time confirmation the first time you turn it on. Syntax checks and dangerous-function scanning run at activation; runtime errors are logged; Safe Mode can pause execution after critical failures. Not every error auto-disables the snippet.

Is PHP sandboxed?

No. WordPress cannot perfectly sandbox arbitrary PHP. Grafucci Code reduces risk with PHP off by default, validation at activation, error logs, Safe Mode, and administrator-only access — but a bad snippet can still affect the site the same way a bad functions.php edit would.

What is the health check?

Tools → System tests includes a free, read-only health check of the plugin environment. It is not marketed as a “Full Scan” of the whole WordPress install. Deeper QA cleanup tools are Pro-gated.

GitHub

Is my GitHub token stored safely?

Tokens are stored encrypted in your WordPress database on your server — not on Grafucci servers. Connect via OAuth Device Flow, or use a repo-scoped personal access token as a fallback. Security notes

Does GitHub Sync run in the background?

No. Sync is manual. You choose when to update from GitHub, review diffs, and push local changes. There is no silent background sync.