sales-skills/sales-superb-addons

Superb Addons Platform Help

Step 1 — Gather context

If references/learnings.md exists, read it first for accumulated platform knowledge.

1. What are you trying to do?

   • A) Fix a broken state — Theme Designer won't load/respond, blocks or CSS unstyled on inner pages, editor breaks after an update or a conflict with another block plugin (e.g. Gutenverse), saved form submissions not showing in wp-admin
   • B) Build with blocks — patterns/pre-built pages, Popup block, Carousel/Slider, Countdown, animations, responsive visibility, Theme Designer layouts
   • C) Forms & lead capture — multi-step forms, calculated fields, conditional logic, anti-spam, where submissions are stored
   • D) Connect/automate — send form submissions to a webhook, Mailchimp, Brevo, Google Sheets, or Slack; read content via the WordPress REST API; hooks/filters
   • E) Pick or compare a plan (Free vs Premium yearly vs lifetime) or weigh Superb Addons vs other block plugins

2. Free or Premium? The plugin is freemium. The WordPress.org readme markets a "free form builder," but the marketing pricing page lists Forms, Popups, 70+ animations, sliders, and the Theme Designer as Premium. Plan gating is genuinely ambiguous — confirm what's unlocked on the actual install before promising a feature (see Gotchas).

Skip-ahead rule: if the user's prompt already contains enough context, skip to Step 2.

Step 2 — Route or answer directly

| Problem domain | Route to | |---|---| | Funnel strategy, page structure, builder selection across tools (Spectra/Kadence/GenerateBlocks/Stackable/Elementor…) | /sales-funnel — Run: /sales-funnel {user's original question} | | A/B testing methodology (Superb Addons has no native split testing) | /sales-vwo — Run: /sales-vwo {user's original question} | | Email sequences/automation after a Superb form opt-in | /sales-email-marketing — Run: /sales-email-marketing {user's original question} | | Growing the list, lead-magnet strategy behind the form/popup | /sales-audience-growth — Run: /sales-audience-growth {user's original question} | | WooCommerce checkout/cart beyond the Add to Cart block | /sales-checkout — Run: /sales-checkout {user's original question} | | On-page/technical SEO and Core Web Vitals beyond Superb's blocks | /sales-seo — Run: /sales-seo {user's original question} |

If the question is Superb-Addons-specific, continue to Step 3.

Step 3 — Superb Addons platform reference

Read references/platform-guide.md for the full reference — blocks/modules, pricing/plan gates, the form data model, and integration recipes. For the form webhook/integration surface, anti-spam config, and WordPress REST/hooks notes, read references/superb-addons-api-reference.md.

Answer the user's question using only the relevant section. Don't dump the full reference.

Step 4 — Actionable guidance

Focus on the user's specific situation.

• Theme Designer not loading/responding is the most-reported issue. First update Superb Addons to the latest version, then run the built-in Troubleshooter (wp-admin → Superb Addons → Get Help → Start Troubleshoot Process), which isolates plugin/theme conflicts. A known conflict: Theme Designer previews break when Gutenverse is active — deactivate the other block plugin to confirm, then clear caches.
• Plan-gating ambiguity drives surprises. Don't assume forms/popups/animations are free just because the readme says so — verify the capability is active on the install. Multi-step forms, integrations, smart popup triggers, the full animation set, and Theme Designer layouts behave as Premium features.
• "Blocks unstyled on inner pages" is the generic block-plugin CSS/asset issue — clear any caching/optimization plugin and CDN, and re-save/regenerate the affected page; allowlist the plugin's assets in minify/security plugins.
• The real automation surface is the form builder, not a hosted API. Superb has no public REST API. To get a lead out: add a webhook to the form (POSTs the submission to your URL) or use the native Mailchimp / Brevo / Google Sheets / Slack integrations. Block content is readable via the WordPress core REST API (/wp-json/wp/v2/...) as namespaced block markup in post_content.
• Submissions storage: the form can store submissions in wp-admin, email admin/user notifications, and auto-delete for GDPR — but a permalink-config bug has hidden saved submissions in the dashboard; update first if they're missing.

If you discover a gotcha, workaround, or tip not covered in references/learnings.md, append it there.

Gotchas

Best-effort from research (2026-06) — review these, especially plan-gated features and integration details that may be outdated.

1. What's free vs Premium is genuinely ambiguous. The WordPress.org readme markets a free form builder ("no license or account needed"), while the SuperbThemes pricing page lists Forms, multi-step forms, Popups with smart triggers, 70+ animations, sliders, Theme Designer, visibility conditions, and advanced custom CSS as Premium. Verify each capability on the live install before relying on it.
2. Theme Designer won't load / doesn't respond when clicked is the top support pattern. Update the plugin, then use the built-in Troubleshooter to bisect conflicts; clear object/page/CDN cache.
3. Conflict with other block plugins — e.g. v4.0.5 fixed Theme Designer previews not rendering when Gutenverse is active. When the editor or previews misbehave, deactivate other block plugins to isolate.
4. Saved form submissions may not display in the wp-admin dashboard under some permalink configurations (a fixed bug) — update to the latest version and re-check Settings → Permalinks (re-save).
5. No public hosted REST API and no inbound API. Outbound automation is the form's webhook + Mailchimp/Brevo/Sheets/Slack integrations; read access is the WordPress core REST API over block markup.
6. No native A/B testing, heatmaps, or analytics — Superb builds pages and captures form leads; measurement needs a separate tool.
7. Block-plugin deactivation risk — like other Gutenberg block addons, pages built with Superb blocks can show invalid-block/raw-HTML warnings if the plugin is deactivated. Test on staging before removing it from a live site.

Related skills

• /sales-funnel — Funnel strategy, page structure, and block-builder selection across tools (Spectra, Kadence Blocks, GenerateBlocks, Stackable, Gutenverse, Elementor, SeedProd)
• /sales-spectra — The closest rival: another Gutenberg-native block plugin that also ships a form builder + Popup Builder; compare blocks, plan gates, and developer hooks
• /sales-stackable — Design-focused Gutenberg block plugin with no form/popup builder — Superb ships both; compare blocks and plan gates
• /sales-gutenverse — Free FSE block plugin (named in Superb's compatibility fixes) — useful when isolating an editor conflict
• /sales-vwo — A/B testing and heatmap methodology Superb lacks natively
• /sales-audience-growth — Growing an email list (lead magnets, opt-in strategy) behind a Superb form or popup
• /sales-email-marketing — Email sequences to run after a Superb form captures the lead (Mailchimp/Brevo and beyond)
• /sales-do — Not sure which skill to use? The router matches any sales objective to the right skill. Install: npx skills add sales-skills/sales --skill sales-do -a claude-code

Examples

Example 1: Send Superb form submissions to my CRM

User: "When someone submits my Superb contact form I want the lead pushed into my CRM automatically — how do I do that without a plugin marketplace connector?" Approach: Superb has no hosted API, so use the form's Webhook integration: on the Superb Form block, add a Webhook that POSTs the submission to an endpoint you control (or a Zapier/Make Catch Hook), then map fields into your CRM. If your CRM is Mailchimp/Brevo, use the native integration instead (no middleware). The exact payload schema isn't published — capture one live delivery to map field keys. See the recipe and field-mapping notes in references/superb-addons-api-reference.md.

Example 2: Theme Designer won't open

User: "I click Theme Designer in Superb Addons and nothing happens / it never loads." Approach: This is the top reported issue. Update Superb Addons to the latest version first (recent releases fixed Theme Designer rendering, including a conflict when Gutenverse is active). Then run the built-in Troubleshooter (Superb Addons → Get Help → Start Troubleshoot Process) to bisect plugin/theme conflicts, and clear object/page/CDN cache. See Troubleshooting.

Example 3: Is the form builder actually free?

User: "The listing says Superb has a free form builder, but the pricing page lists Forms under Premium. Which is it?" Approach: Plan gating is genuinely ambiguous between the WordPress.org readme and the marketing pricing page. Treat multi-step forms, calculated fields, integrations (Mailchimp/Brevo/Sheets/Slack/webhook), smart popup triggers, the full animation set, and Theme Designer layouts as Premium, and verify what's unlocked on the actual install before committing. Confirm current tiers/prices (Free; Premium ~$29–$49/yr or ~$59–$99 lifetime by site count) in references/platform-guide.md — pricing is best-effort.

Troubleshooting

Theme Designer won't load or respond

Symptom: Clicking Theme Designer does nothing, or it never finishes loading. Cause: An outdated plugin version or a conflict with another block plugin/theme (a known one: previews failing when Gutenverse is active). Solution: Update Superb Addons to the latest version. Run the built-in Troubleshooter (Superb Addons → Get Help → Start Troubleshoot Process) to isolate the conflict; deactivate other block plugins one at a time to confirm. Clear object cache, page cache, and CDN, then retry.

Saved form submissions don't appear in the dashboard

Symptom: Form submissions are configured to be stored, but the admin list is empty. Cause: A permalink-configuration bug that prevented saved submissions from displaying in wp-admin for some setups (addressed in a recent release). Solution: Update to the latest version. Go to Settings → Permalinks and re-save (flushes rewrite rules). Submit a test entry and confirm it appears; also verify the form's "store submissions" option is enabled and email notifications are configured as a backup.

Superb blocks render unstyled or broken on inner pages

Symptom: A pattern/page looks correct in the editor or on the homepage but unstyled on other pages. Cause: The plugin's per-page CSS/assets aren't loading sitewide, or a caching/optimization/minify plugin is stripping or deferring them. Solution: Clear page cache + CDN and re-save the affected page. In any minify/optimization/security plugin, allowlist Superb's assets (don't combine/defer them) and exclude its scripts from JS deferral. Confirm the page isn't pulling a stale cached version.