Plugin documentation

Install, configure, and run your Neon.Computer plugins with confidence.

Use this guide to set up each product, understand the feature set, unlock N.C. External Products Suite, and troubleshoot the most common setup or workflow issues.

Products

Explore our suite of WordPress tools.

Manual

N.C. External Products user guide.

N.C. External Products helps WooCommerce store owners showcase Etsy listings on their own WordPress site without rebuilding products manually or pretending WooCommerce is the checkout system.

Quick start

Install the plugin and create your first Etsy-connected products.

  1. Download the latest ZIP from the N.C. External Products site.
  2. In WordPress, go to Plugins > Add New > Upload Plugin.
  3. Upload the ZIP, activate it, and open N.C. External Products.
  4. Start with Quick Add for one listing or use CSV Import if you already exported listing data.
  5. Review the import preview before saving products.
  6. Open Link Health after import to confirm your Etsy destinations are reachable.
Best first test: create one listing with Quick Add first. It confirms your storefront, WooCommerce external-product behavior, and Etsy URL handling before you import a larger batch.

Plans

Free is Etsy-focused. N.C. External Products Suite adds other external product sources.

N.C. External Products Free is the Etsy-focused starting point for a live store. N.C. External Products Suite unlocks supported non-Etsy external URLs, automation, updates, reporting, and multi-site bundles.

N.C. External Products FreeEtsy-connected products, manual imports, quick add, manual link checks, and the core WooCommerce external-product workflow.
N.C. External Products Suite SoloOne site, supported non-Etsy external URLs, bulk update controls, image handling, click tracking, and export tools.
N.C. External Products Suite StudioFive sites, supported external destinations, scheduled checks, email summaries, and more operational tooling.
N.C. External Products Suite AgencyTwenty-five sites, client-friendly workflows, supported external destinations, and priority support.
  1. Choose a Suite package from the product pricing page when you outgrow Free.
  2. Complete one-time checkout through Neon.Computer.
  3. Open N.C. External Products > Dashboard and connect the license key.
  4. N.C. External Products Suite features unlock immediately after successful activation.

License and billing

Use the free version first, then unlock Suite with a license key when you are ready.

The plugin starts as the free Etsy-focused version. When a store needs non-Etsy external destinations or more operational tooling, checkout happens on the N.C. External Products site and the Neon.Computer Support Hub handles the Suite license key, recovery, and purchase support links.

  1. Buy N.C. External Products Suite Solo, N.C. External Products Suite Studio, or N.C. External Products Suite Agency from the N.C. External Products pricing section.
  2. Watch for the license email sent after checkout.
  3. Open N.C. External Products > Dashboard in WordPress.
  4. Paste the key into the License And Plan card and click Connect License.
  5. Use Check Status any time you want to verify the site is still activated.
Recover licenseIf the key was lost, use the Support Hub recovery form and the purchase email address.
Purchase helpSuite customers can use the Support Hub for receipts, license recovery, refund questions, or checkout issues.
Move a licenseDisconnect the license from the old site first, then connect it on the replacement site.
Free to SuiteNo reinstall is required. N.C. External Products Suite features unlock after the license activates successfully on that WordPress site.

CSV import

Preview the catalog before you create products.

The import flow is designed to reduce surprises. Upload a CSV, review the field mapping, inspect sample rows, and then create WooCommerce external products that link shoppers back to Etsy.

  • Use the preview step to confirm title, price, URL, SKU, and image columns.
  • Duplicate protection checks Etsy listing ID, SKU, and source URL.
  • Free is create-focused. N.C. External Products Suite unlocks stronger update and overwrite controls.
  • If a row says it will update an existing product, review that match before import.
Important: this plugin creates WooCommerce external products. It does not clone Etsy checkout, order history, or inventory sync inside WooCommerce.

Quick add

Add one Etsy listing without building a CSV first.

Quick Add is the fastest route when you only need a handful of products or want to validate the workflow before importing more. Paste the Etsy listing URL, confirm the product fields, and save.

  • Use Quick Add for one-off products, new launches, or testing.
  • Free users can use Quick Add for Etsy listings without a local product cap.
  • Paid plans make more sense once you are maintaining a real catalog.

Settings

Control how imports, images, tracking, and cleanup behave.

Import behaviorSet product status, duplicate handling, and how conservative imports should be.
ImagesChoose whether to keep remote image URLs only or enable stronger image handling with Suite.
Click trackingEnable tracked outbound clicks with Suite if you want click counts and reporting.
AutomationConfigure scheduled checks and alerts with Suite.
PortabilityPaid bundles can export and import settings for repeatable site setups.
CleanupOptional plugin-data cleanup affects plugin settings and logs, not your WooCommerce products.

Mapping presets

Save a known-good field map so repeated imports take less babysitting.

When the preview step correctly matches a custom CSV layout, Suite can save that mapping as a reusable preset. That is helpful when a team exports from the same Etsy workflow repeatedly or cleans listing data in spreadsheets before upload.

  • Save a preset from the Import Preview screen after you confirm the detected columns.
  • Use a clear preset name, such as the storefront name or export source.
  • Delete old presets from the Mapping Presets tab when they no longer match your CSV structure.
  • Free can auto-detect columns but cannot store reusable presets.

Click tracking

Count outbound Etsy clicks without pretending WooCommerce owns the sale.

Paid plans can route WooCommerce external-product clicks through a lightweight local redirect first. That makes it possible to record which products are actually sending shoppers to Etsy while still letting Etsy handle the checkout.

Total clicksAll tracked outbound Etsy clicks stored for the current site.
This monthClicks recorded in the current calendar month for quick performance checks.
Tracked productsHow many WooCommerce products have recorded at least one outbound Etsy click.
ExportsPaid bundles can export click reports for reporting, cleanup, or handoff work.

Automation and reports

Use paid tooling when the catalog becomes something you actively maintain.

Free is intentionally manual. N.C. External Products Suite adds automation and reporting once the storefront has enough products that broken links, stale listings, and repeated admin work start costing real time.

Scheduled checksRun link-health checks daily or weekly without manually opening the tab each time.
Email summariesSend issue summaries to the configured alert email when automated checks find problems.
Export diagnosticsCreate a support-friendly snapshot of plugin settings and environment details.
Catalog reportsExport audits, stale rows, click reports, and settings backups with Suite.

Troubleshooting

Common issues and what they usually mean.

Why did the import preview show no usable rows?

The CSV may be missing the Etsy URL column, using unexpected delimiters, or mapping the wrong columns. Start with the sample CSV format and compare your file to it.

Why was a product blocked on Free?

Free is Etsy-focused. Upgrade when you need non-Etsy external URLs, automation, exports, and reporting.

Why does a link health check show broken?

The Etsy listing may be gone, private, region-limited, temporarily blocked, or returning an unexpected response. Open the stored URL directly and confirm the listing still exists.

Can this plugin sync Etsy orders, inventory, or shipping?

No. The plugin is focused on storefront presentation, CSV-based catalog creation, and link integrity for WooCommerce external products.

Why did a paid feature still look locked after checkout?

Open the Dashboard tab, paste the license key, and connect the license. Buying a plan alone does not change the local WordPress site until the license is activated there.

Data and performance

How the plugin stores Etsy catalog data.

N.C. External Products stores the import results, product metadata, click counts, and link-health results in the customer site's WordPress database. Normal admin screens read that saved data instead of re-fetching remote catalog information every time the page loads.

  • CSV preview files are temporary and cleaned up after import workflows.
  • WooCommerce products remain in the store unless you remove them yourself.
  • Optional cleanup targets plugin settings and logs, not the actual imported products.
  • Remote requests happen when you run link checks, follow tracked clicks, or import referenced images on supported paid workflows.

Manual

N.C Decay Scanner user guide.

N.C Decay Scanner is the free WordPress plugin for finding content decay, prioritizing refresh opportunities, and exporting a clean action queue. It does not require a license key and does not include AI briefs or draft generation.

Quick start

Install Scanner and run the first useful scan.

  1. Install N.C Decay Scanner from the WordPress Plugin Directory.
  2. In WordPress, go to Plugins > Add New and search for N.C Decay Scanner.
  3. Install, activate it, then open N.C Decay Scanner > Setup.
  4. Connect Google Search Console and choose the matching property.
  5. Run a live scan, then open Opportunities to review the highest-priority pages.

Workflow

Use Scanner for discovery and triage.

  • Find declining URLs from Search Console data.
  • Sort opportunities by priority score, click loss, visibility changes, content type, owner, and status.
  • Add notes, assign owners, update workflow states, and export CSVs for handoff.
  • Scanner does not create AI briefs, rewrite content, or generate refresh drafts.

Upgrade path

Use Fixer when discovery turns into production.

Upgrade to N.C Decay Fixer when the team needs AI refresh briefs, safe WordPress drafts, source-vs-draft diffs, scheduled monitoring, alerts, multi-site licensing, or premium support.

Manual

N.C Decay Fixer user guide.

N.C Decay Fixer is the separate premium plugin for turning Scanner findings into AI briefs, safe drafts, scheduled monitoring, alerts, licensing, and support.

Quick start

Install N.C Decay Fixer after Scanner identifies work worth producing.

  1. Buy Solo, Studio, or Agency from the N.C Decay Fixer pricing page.
  2. Download the premium N.C Decay Fixer ZIP after checkout.
  3. In WordPress, go to Plugins > Add New > Upload Plugin.
  4. Upload the premium ZIP, activate it, then open N.C Decay Fixer > Settings > License.
  5. Paste the license key from the Neon.Computer Support Hub email.
  6. Confirm Search Console is connected and open Opportunities to start premium refresh work.
Best first test: load demo data after installation, then run a live scan after Search Console is connected. Demo data lets you understand the queue before waiting on Google data.

Products

Free Scanner, separate premium Fixer.

N.C Decay Scanner is the free plugin for Search Console connection, live scans, decay scoring, the opportunity queue, workflow notes, owners, statuses, and manual CSV export. It does not require a license key and does not include AI briefs or draft generation.

N.C Decay Fixer is the paid plugin. It is installed separately when you buy Solo, Studio, or Agency, and it adds AI refresh briefs, scheduled monitoring, email or webhook alerts, safe refresh drafts, premium support, and additional site activations depending on plan.

  1. Use N.C Decay Scanner first if you only need scanning and prioritization.
  2. Choose Solo, Studio, or Agency from the N.C Decay Fixer pricing page when you want premium fixing tools.
  3. Complete Stripe Checkout.
  4. The Neon.Computer Support Hub creates your license key and emails it to you.
  5. Install the premium N.C Decay Fixer ZIP provided after purchase.
  6. In WordPress, open N.C Decay Fixer > Settings > License.
  7. Paste the license key and click Connect License.

Google Search Console

Connect Search Console without making your own Google app.

The recommended connection method is the Neon.Computer Google connection flow. It opens Google sign-in, asks for read-only Search Console access, then returns your available properties to WordPress so you can choose the right one.

Recommended connection

  1. Open N.C Decay Scanner or N.C Decay Fixer > Setup or Settings.
  2. Select One-click Google connection.
  3. Click Connect.
  4. Approve the Google account that has access to your Search Console property.
  5. Choose the exact property for the WordPress site, then save.

Property tips

  • Use the property that matches the canonical version of the site.
  • Domain properties look like `sc-domain:example.com`.
  • URL-prefix properties look like `https://example.com/`.
  • If the dropdown is empty, reconnect and confirm the Google account has Search Console access.

Advanced self-hosted OAuth

Advanced OAuth is available for teams that want to use their own Google Cloud app. Most users should avoid this path unless their organization requires self-managed OAuth credentials.

Scans

Run a scan and understand the result.

A live scan compares current Search Console performance against a previous period, then matches Search Console URLs to published WordPress content.

  1. Open N.C Decay Scanner or N.C Decay Fixer > Dashboard.
  2. Click Run Live Scan.
  3. Wait for the scan to finish and review the dashboard summary.
  4. Open Opportunities to inspect flagged pages.

If a scan returns zero rows

  • Search Console may not have data for the selected time window yet.
  • The property may not match the WordPress site URLs.
  • The minimum previous-click threshold may be filtering out low-volume pages.
  • Only selected post types are scanned.
  • Ignored URL rules may be excluding URLs.

Dashboard

Use the dashboard as your command center.

The dashboard tells you whether setup is complete, when data was last updated, and how much content needs attention.

Setup progressShows whether Search Console, property selection, scan rules, and first scan are ready.
Clicks at riskEstimated click loss from pages flagged by the latest scan.
High priorityPages with the strongest refresh signal based on score.
Data freshnessWhether scan results are current enough to trust.
Scan historyTrend view of flagged pages, high-priority pages, and clicks at risk.
Setup checklistNext actions for connecting, scanning, and enabling premium Fixer tools when applicable.

Opportunities

Prioritize the pages most worth refreshing.

The opportunity queue is where scan results become editorial work. Use saved views for quick triage, filters for deeper review, and workflow states to track progress.

Common saved views

  • High Priority: pages with the strongest refresh score.
  • Losing Clicks: pages with meaningful click decline.
  • Losing Impressions: pages losing visibility before clicks fall further.
  • Needs Review: pages ready for editorial decision-making.
  • Drafts Created: pages already moved into refresh draft workflow.

Queue columns

Scan StatusSEO signal from the latest scan, such as high priority, review, growing, or recovered.
WorkflowYour team's editorial state, such as New, In Review, Draft Created, Updated, Ignored, or Recovered.
SignalWhether the page is newly decaying, worsening, improving, recovered, or unchanged.
ScorePriority score based on traffic loss, ranking movement, demand, and configured thresholds.

Workflow

Move from SEO insight to editorial action.

Each opportunity can be assigned, noted, exported, ignored, or moved through workflow states. This makes Scanner useful for solo site owners and teams, with Fixer available when a page is ready for deeper refresh production.

  1. Open an opportunity from the queue.
  2. Review the score reasons and performance changes.
  3. Assign an owner if a team member should handle the refresh.
  4. Add notes with decisions, context, or client instructions.
  5. Move the workflow state as work progresses.
  6. Use N.C Decay Fixer to create a refresh draft when you are ready to write.
Safe draft behavior: N.C Decay Fixer creates separate refresh drafts. It does not overwrite the live post.

AI

Generate optional premium AI refresh briefs.

AI refresh briefs are part of N.C Decay Fixer. They require an active Solo, Studio, or Agency license plus your own OpenAI API key. OpenAI may bill your OpenAI account for usage. N.C Decay Scanner does not include AI briefs.

AI brief sections

  • Priority explanation in plain English.
  • Suggested title and intro improvements.
  • Outline additions and missing sections.
  • Freshness audit for outdated claims, dates, tools, prices, or screenshots.
  • FAQ suggestions.
  • Meta title and meta description ideas.
  • Internal link suggestions from existing site content.

How to enable AI

  1. Activate a Solo, Studio, or Agency license.
  2. Open N.C Decay Fixer > Settings > AI Refresh Briefs.
  3. Add your OpenAI API key.
  4. Confirm the model name.
  5. Enable AI suggestions and save settings.

Settings

Settings reference.

Scan windowNumber of days in each comparison period. A 28-day window compares the latest 28 days against the prior 28 days.
Comparison modeRolling windows are easiest. Custom ranges are useful for campaigns, launches, seasonal content, or client reporting.
Minimum previous clicksFilters low-volume pages so the queue focuses on content with enough search demand to matter.
Tracked post typesChoose whether posts, pages, media, or custom post types should be included in scans.
Scheduled scansFixer feature. Runs automatic live scans through WP-Cron after Search Console is connected.
Email digestsFixer feature. Sends scan summaries to the configured recipient.
Webhook alertsFixer feature. Sends JSON alerts to Slack, Zapier, Make, or any HTTPS endpoint that accepts POST requests.
URL ignore rulesExclude URLs from future scans when they are irrelevant, obsolete, or intentionally outside the workflow.
Import/export settingsMove scan rules and preferences between sites. Secret values are excluded by default.
Debug loggingUse when troubleshooting API failures. Turn off after support no longer needs diagnostic detail.

Advanced

Advanced options for power users and agencies.

Custom date ranges

Use custom ranges when comparing a specific campaign window, seasonal period, or before/after content refresh. Current and previous ranges should be the same length and should not overlap.

Single URL scan

Use a single URL scan when a stakeholder asks about one page or when you want to verify whether Google has data for a specific post.

CSV exports

Use exports for client reporting, editorial handoff, or archiving a refresh plan. Filter the queue first if you only want a focused export.

Production constants

Developers can define sensitive values in `wp-config.php` for production environments, including Search Console property, advanced OAuth credentials, and, for Fixer, OpenAI API key and webhook URL.

Troubleshooting

Common issues and what to check first.

Search Console connects, but no properties appear.

Refresh the settings page, reconnect, and make sure the Google account has access to the Search Console property. If the property still does not load, paste the exact property and open a support request.

A scan says zero tracked URLs were scanned.

Confirm the site has published posts or pages, tracked post types are enabled, and the selected Search Console property matches the WordPress site URLs.

A scan ran, but Search Console returned no matching rows.

Google may not have data for the chosen window, URLs may not match the property, or the minimum-click threshold may be too high. Load demo data if you want to preview the workflow immediately.

AI suggestions are disabled.

AI refresh briefs require N.C Decay Fixer, an active Solo, Studio, or Agency license, an OpenAI API key, a model name, and the AI suggestions toggle enabled. If requests fail, confirm the license is connected and the OpenAI key has API access and billing available.

Paid features remain locked after purchase.

Install N.C Decay Fixer and connect the license key in N.C Decay Fixer > Settings > License. If the key was lost, use license recovery from this support hub.

Billing portal will not open.

Use the same email and license key from checkout. Test-mode purchases cannot open the live Stripe billing portal.

Performance

How the Decay plugins handle Search Console data.

N.C Decay Scanner and N.C Decay Fixer are designed so normal dashboard views do not call Google Search Console. Google is queried when a user runs a live scan, scans a single URL, refreshes the property list, or when a Fixer scheduled scan runs.

Dashboard views use saved scan results.

After a scan completes, the plugin stores processed opportunity rows, last-scan metadata, and scan history summaries in the customer site's WordPress database. Dashboard cards, filters, saved views, workflow states, owners, notes, and exports read from that saved data.

Search Console responses are short-lived cache.

Search Analytics responses are cached briefly for duplicate requests, and property lists are cached briefly while setup is active. This reduces repeated API calls without turning the plugin into a permanent raw Search Console warehouse.

Stored history is intentionally bounded.

The plugin keeps the latest saved opportunity set and up to 10 scan history summaries. The current release is tuned for focused WordPress content audits, with scan volume intentionally capped for shared-hosting reliability.

Admins have cleanup controls.

Settings include controls to clear temporary Search Console cache and clear saved scan results/history. Uninstall removes the active Decay plugin options and scheduled hooks from the WordPress site.

Agency answer: The Decay plugins do not hit Google on every dashboard load. They run scans on demand or schedule, cache duplicate API responses briefly, then serve the working dashboard from saved scan data in WordPress.

Data and privacy

What connects to outside services.

The Decay plugins connect to outside services only when the related feature is used.

  • Google Search Console provides OAuth, property lists, and Search Analytics query data.
  • The Neon.Computer Google connection flow helps users complete sign-in without making their own Google Cloud app.
  • The Neon.Computer Support Hub handles Fixer licenses, support requests, billing links, and license recovery.
  • OpenAI is used only in N.C Decay Fixer if a site admin adds an API key and enables AI suggestions.
  • Stripe handles checkout and billing. Neon.Computer does not store full card numbers.