Nuwtonic User Guide

This handbook walks you through Nuwtonic from first workspace setup to weekly SEO and GEO operations. Follow it if you want clear product steps without developer detail.

For connection-specific setup, open the matching integration guide:

Browse every guide from the Docs home.

What Nuwtonic helps you do

Nuwtonic is an agentic SEO workspace. Inside one workspace you can:

• review Google Search performance for your site;
• track how AI answer engines mention and cite your brand;
• audit pages and apply SEO or GEO fixes;
• research keywords and competitors;
• generate and publish content;
• run focused agents for schema, meta, alt text, and FAQs.

Work happens inside a workspace. A workspace is usually one website or domain.

Tip: Connect Google Search Console first. Then connect one CMS integration before you publish content or push fixes.

1. Get started

Create your account

1. Open Nuwtonic and sign up or log in.
2. After login, you land on Workspaces.
3. If your plan or organization is not ready yet, finish organization setup first.

Create a workspace

The best way to create a workspace is with Google Search Console (GSC). Full setup detail is in the Google Search Console guide.

1. From Workspaces, choose create or import.
2. Authorize Google Search Console when prompted.
3. Select the verified property you want to manage.
4. Confirm and create the workspace.

If you cannot connect GSC yet, you can create a workspace from a website URL. Some performance screens stay limited until GSC is connected. Connect GSC when you can.

Finish first-time setup

After the workspace is created, Nuwtonic may ask you to choose setup modules and a seed keyword.

1. Select the modules you want to start with.
2. Enter a clear seed keyword for your business or site.
3. Start setup and wait until the workspace is ready.
4. Open the workspace dashboard.

Setup usually takes a few minutes. Stay on the page until it finishes.

Recommended first path

1. Open the Performance Dashboard.
2. Connect an integration if you want to publish content or push fixes to your CMS.
3. Run one SEO audit on an important page.
4. Generate one article from Content Generation.
5. Review AI Search Visibility after you add a few prompts.

2. How to move around the app

Use the left sidebar inside a workspace. The main areas are:

• Dashboard — workspace overview and performance home.
• AI Search Visibility — brand visibility in AI answers.
• SEO Performance — Google Search data, ranking, and SEO audits.
• Content Generation — planning, writing, and publishing content.
• Competitor Gap — competitor and opportunity analysis.
• Keyword intelligence — keyword research and clusters.
• Auto Traffic Campaign — recovery and growth campaigns.
• Individual Agents — schema, meta, alt text, FAQ tools.
• Integrations — connect WordPress, Shopify, Ghost, Webflow, or webhook.
• Settings — workspace webhook settings and danger zone actions.

Your organization settings (profile, subscription, team) live outside the workspace sidebar.

3. Dashboard and SEO Performance

Performance Dashboard

Open SEO Performance → Performance Dashboard to review:

• clicks, impressions, CTR, and average position;
• trends and movers;
• pages and queries that need attention;
• opportunities such as CTR uplift, cannibalization, and device gaps.

Use this screen to decide where to spend time next. Prefer pages with strong impressions but weak CTR or declining clicks.

Keyword Ranking

Open Keyword Ranking to track query performance over time. Use it when you want to monitor specific search terms after content updates or fixes.

SERP Ranking

Open SERP Ranking to review position tracking style results. Use it when you want a clearer view of how pages are competing in search results.

If GSC data is missing

If charts or tables look empty:

1. Confirm the workspace is connected to the correct GSC property.
2. Confirm the property has search data in Google Search Console.
3. Wait for a refresh if the workspace was just created.
4. Recreate or reconnect with GSC if the workspace was created from URL only.

4. SEO Audit and Fix

Use this when you want to improve on-page SEO for Google Search.

1. Open SEO Performance → SEO Audit & Fix.
2. Choose a single page, bulk pages, or the available sitewide option.
3. Enter or select the page URL you want to audit.
4. Run the audit and wait for results.
5. Review the issues and recommended fixes.
6. Apply the fixes you want to keep.

After the audit

• Use SEO Audit Dashboard to review recent audit status and outcomes.
• Use Advanced SEO Optimizations for deeper fix work when available on your plan.
• If an integration is connected, push approved fixes to your CMS carefully and check the live page after publishing.

Good habits

• Start with high-impression pages.
• Apply one clear set of fixes, then re-check the page.
• Do not apply conflicting changes to the same page at the same time.
• Keep a note of pages you changed so you can measure results later in the dashboard.

5. AI Search Visibility

Use this area to understand whether AI systems mention and cite your brand.

Dashboard

Open AI Search Visibility → Dashboard for an overview of brand visibility across tracked prompts and providers.

Prompts & Runs

1. Open Prompts & Runs.
2. Add prompts that real buyers or users would ask AI tools.
3. Run tracking.
4. Review visibility score, citation rate, and top placement signals.

Write prompts the way a customer would ask them. Vague prompts produce vague insights.

Citations

Open Citation to see which URLs or snippets are being cited in AI answers. Prefer strengthening pages that already earn citations, then expand into missing topics.

GEO Audit & Fix

Use GEO audit when you want pages to be clearer and more citable for AI answer engines.

1. Open GEO Audit & Fix.
2. Choose a page URL.
3. Run the audit.
4. Review AI-readiness issues such as structure, clarity, schema, and citation readiness.
5. Apply the recommended fixes.

Use the GEO Audit Dashboard to monitor progress across audits.

AI Impact

If available on your account, follow the connection steps shown in the screen to relate AI visibility to traffic outcomes before expecting impact charts.

6. Content Generation

Use Content Generation when you need new SEO and GEO-ready articles.

Brand Analysis

Start here if the brand voice is not set yet.

1. Open Brand Analysis.
2. Review or complete brand, audience, and messaging inputs.
3. Save the analysis so later articles stay consistent.

Preset

Open Preset to set default generation preferences for your workspace. Keep presets simple and reusable.

Topical Map

1. Open Topical Map.
2. Review topic clusters and content opportunities.
3. Expand a cluster when you need more article ideas.
4. Send selected topics into writing or planning.

GEO Content Writer

1. Open GEO Content Writer.
2. Enter a target keyword or select topics from your map.
3. Choose language and generation options shown on the screen.
4. Generate the article.
5. Open the editor to review title, structure, meta details, and body content.
6. Save as draft or publish when ready.

Always review AI-generated content before publishing. Check facts, product claims, internal links, and brand voice.

Planner

Open Planner to manage article status and publishing schedule.

Typical statuses include planned, draft, and published. Use the planner to keep a clear queue instead of generating articles without a publishing plan.

7. Keyword intelligence

Keyword Research

1. Open Keyword Research.
2. Enter a seed keyword.
3. Review volume, intent, difficulty, and opportunity signals.
4. Save or shortlist keywords you want to write about or track.

Use research before bulk content generation so you write for demand, not only for ideas.

Serp Based Keyword Clusters

1. Open Serp Based Keyword Clusters after research.
2. Review clusters and recommended next actions.
3. Choose clusters that match your business priority.
4. Move selected topics into Topical Map, Content Writer, or your campaign plan.

8. Competitor Gap

Know Your Competitor

1. Open Know Your Competitor.
2. Review domains that appear in AI answers for your space.
3. Add or remove competitor domains as needed.
4. Use the list to decide which rivals to study next.

Opportunity Gap

Open Opportunity Gap to find keywords or topics where competitors win and you are missing coverage. Prioritize gaps that match your product, service, or content strengths.

9. Auto Traffic Campaign

Use Auto Traffic Campaign when you want a guided recovery or growth push from existing GSC opportunities.

1. Open Auto Traffic Campaign.
2. Choose a strategy such as growth, recovery, or defense when offered.
3. Review eligible pages.
4. Select the pages you want to include.
5. Run the campaign or advanced SEO fix flow shown on the screen.
6. Monitor results in SEO Performance after the work completes.

Start with a small page set. Confirm results before expanding the campaign.

10. Individual Agents

Use Individual Agents for focused tasks on one page or a selected set of pages.

Schema Agent

Creates or updates structured data for selected URLs. Use it when pages need clearer article, FAQ, or other schema support.

Meta Agent

Creates or improves titles and meta descriptions. Use it for high-impression pages with weak CTR.

Alt Text Agent

Creates image alt text. Use it when important images are missing useful descriptions.

FAQ Agent

Creates FAQ content for a page. Review the questions for accuracy before publishing.

Optimization History

Open Optimization History to review past agent runs and outputs. Use it when you need to confirm what was generated earlier.

11. Integrations and publishing

Open Integrations to connect your CMS. Google Search Console is connected through its own product flow and has a dedicated guide.

Choose the right integration

Connect a CMS integration

1. Open Integrations.
2. Choose the platform you use.
3. Follow the on-screen connection steps, or open the detailed guide above if a credential is unclear.
4. Save the connection.
5. Test publishing or fix delivery with a low-risk page first.

Usually one active CMS integration is enough for a workspace. If you switch platforms, disconnect the old one before relying on the new one.

Quick platform notes

WordPress

• Download and install the Nuwtonic WordPress plugin.
• Copy the Website ID into the plugin and connect.
• Confirm the plugin stays active before publishing.
• Full steps: WordPress Integration Guide

Shopify

• Create app Admin API access in Shopify and copy the access token.
• Paste the shop domain and token into Nuwtonic.
• Add the theme Liquid snippet so meta and schema render in <head>.
• Full steps: Shopify Integration Guide

Webflow

• Generate a site API token in Site settings → Apps & integrations.
• Paste the token and CMS Collection ID into Nuwtonic.
• Full steps: Webflow Integration Guide

Ghost

• Create a custom integration in Ghost Admin.
• Paste the Admin API Key and site API URL into Nuwtonic.
• Full steps: Ghost Integration Guide

Webhook

• Use webhook when your CMS is custom.
• The signing secret is created when you save webhook settings. Keep that secret private.
• Full technical setup: Webhook Integration Guide

12. Citation Exchange

If Citation Exchange is available on your account:

1. Open Citation Exchange.
2. Enroll your domain when ready.
3. Host approved partner citations when the product asks you to.
4. Earn credits for hosting and spend credits when you want citations elsewhere.
5. Pause matching if you need to stop participation temporarily.

Only approve citation placements that fit your content and audience.

13. Settings, credits, and team

Workspace Settings

Open workspace Settings to manage:

• webhook delivery settings;
• reporting options when available;
• workspace deletion.

Deleting a workspace is permanent. Type the confirmation exactly as shown before you continue.

Organization settings

From account or organization settings you can manage:

• profile details;
• subscription and AI credits;
• team members and seats;
• security options;
• white-label options when included in your plan.

AI credits

Many actions use AI credits, including audits, generation, research, and campaigns. If an action is blocked:

1. Open subscription or usage settings.
2. Confirm your plan still has available credits.
3. Wait for renewal or purchase more credits if your plan allows it.
4. Retry the action.

14. Common tasks

Improve a page that already ranks

1. Find the page in Performance Dashboard.
2. Run SEO Audit & Fix.
3. Apply meta, content, and schema fixes that are clearly useful.
4. Publish through your integration.
5. Recheck the page after a few days in Keyword Ranking and Performance Dashboard.

Create a new ranking page

1. Research the keyword.
2. Confirm the topic in Topical Map or Keyword Clusters.
3. Generate the article in GEO Content Writer.
4. Edit and fact-check the draft.
5. Publish as live or save as draft from Planner.
6. Track the keyword afterward.

Improve AI citations

1. Add buyer-style prompts in Prompts & Runs.
2. Identify missing citations.
3. Run GEO Audit & Fix on the strongest candidate page.
4. Improve clarity, structure, FAQ support, and schema.
5. Rerun prompts later and compare citation results.

Recover declining traffic

1. Open Performance Dashboard and find declining pages.
2. Start a focused Auto Traffic Campaign or Advanced SEO Optimization.
3. Apply fixes to the selected pages.
4. Monitor clicks and position changes after publishing.

15. Troubleshooting

I cannot create a workspace

• Confirm you are logged into the correct account.
• Confirm your plan allows another workspace.
• Retry GSC authorization and choose a verified property.

My dashboard has little or no data

• Confirm GSC is connected.
• Confirm the property has search traffic.
• Wait for the first sync after workspace creation.
• Check that you opened the correct workspace.

An audit or generation failed

• Confirm you still have AI credits.
• Confirm the page URL is public and reachable.
• Retry once.
• If it fails again, note the page URL and contact support.

Publishing did not update my CMS

• Confirm the integration is connected and enabled.
• Confirm you chose publish rather than draft when that option exists.
• For WordPress, confirm the plugin is active and the Website ID matches.
• For webhook, confirm your endpoint is online and the signing secret is current.
• Open the CMS and verify whether a draft was created instead of a live post.

Fixes look wrong on the live page

• Open the page in a private browser window.
• Confirm the correct URL was updated.
• Re-run a focused agent or audit only for the broken part.
• Roll back the CMS change if your CMS supports revisions.

16. Weekly checklist

Use this short checklist to stay consistent:

1. Review Performance Dashboard for movers and declines.
2. Check AI Search Visibility for new citation wins or losses.
3. Audit and fix one high-priority page.
4. Advance one article from Planner to published.
5. Review one keyword or competitor gap opportunity.
6. Confirm integrations and credits are healthy.

17. Where to get more help

• Product walkthrough: this User Guide
• All docs: Docs home
• Google Search Console: GSC guide
• WordPress: WordPress guide
• Shopify: Shopify guide
• Webflow: Webflow guide
• Ghost: Ghost guide
• Webhooks: Webhook Integration Guide
• Agentic SEO concepts: What is Nuwtonic
• Contact support from the Contact page if a workspace action stays blocked after the steps above

When you contact support, include the workspace name, the page URL, the feature you used, and what you expected to happen. That helps the team resolve the issue faster.