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

Create a workspace 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. Choose the Target Country for your SEO, GEO, brand visibility, and competitor analysis. The default is United States (US).
5. Confirm and create the workspace.

You need a verified Search Console property and a Google account with access to that property. If authorization fails, retry with the correct account or finish verification in Search Console first.

Choose the country where you primarily want to reach customers. You can change it later from Brand Analysis. See Why Target Country matters for which features use it and why.

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. Reconnect GSC and select the matching verified property again.

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. Select Edit Analysis.
3. Review or change Target Country. Country codes use the two-letter format, such as US or IN.
4. Review or complete the brand, audience, and messaging inputs.
5. Select Save Changes, then select Analyze Brand if you changed the country so the analysis matches your new market.

See Why Target Country matters below for a full list of features that read this setting and why it matters.

Why Target Country matters

Your Target Country is the main market you want to reach — for example, customers in the United States (US) or India (IN). You set it when you create a workspace, and you can change it anytime in Brand Analysis.

Search results, AI answers, and competitors are not the same in every country. Nuwtonic uses your Target Country so recommendations match the place where you actually sell or want to grow.

Where Nuwtonic uses your Target Country

When to update it

• You mainly sell in one country today, but you are expanding to another.
• Your competitor or AI visibility results feel wrong for your real market.
• You imported a workspace and the default US is not your primary audience.

After you change the country in Brand Analysis, select Save Changes, then Analyze Brand. Open Know Your Competitor or AI Search Visibility again so those areas refresh for the new country.

Country codes use two letters, such as US, IN, GB, or DE.

Español — Por qué importa el país objetivo

Tu País objetivo es el mercado principal al que quieres llegar — por ejemplo, clientes en Estados Unidos (US) o India (IN). Lo eliges al crear el espacio de trabajo y puedes cambiarlo en cualquier momento en Análisis de marca.

Los resultados de búsqueda, las respuestas de la IA y los competidores no son iguales en todos los países. Nuwtonic usa tu País objetivo para que las recomendaciones encajen con el lugar donde realmente vendes o quieres crecer.

Dónde lo usa Nuwtonic

Cuándo actualizarlo

• Vendes sobre todo en un país, pero quieres crecer en otro.
• Los resultados de competidores o visibilidad en IA no encajan con tu mercado real.
• Importaste un espacio de trabajo y el valor predeterminado US no es tu audiencia principal.

Después de cambiar el país en Análisis de marca, guarda los cambios y selecciona Analizar marca. Vuelve a abrir Conoce a tu competidor o Visibilidad en búsqueda con IA para refrescar esos datos.

Los códigos de país usan dos letras, como US, IN, GB o DE.

Français — Pourquoi le pays cible compte

Votre Pays cible est le marché principal que vous voulez toucher — par exemple, des clients aux États-Unis (US) ou en Inde (IN). Vous le choisissez à la création de l'espace de travail et pouvez le modifier à tout moment dans Analyse de marque.

Les résultats de recherche, les réponses de l'IA et les concurrents ne sont pas les mêmes dans tous les pays. Nuwtonic utilise votre Pays cible pour que les recommandations correspondent à l'endroit où vous vendez réellement ou souhaitez grandir.

Où Nuwtonic l'utilise

Quand le mettre à jour

• Vous vendez surtout dans un pays aujourd'hui, mais vous vous développez ailleurs.
• Les résultats concurrents ou de visibilité IA ne correspondent pas à votre vrai marché.
• Vous avez importé un espace de travail et la valeur par défaut US ne correspond pas à votre audience principale.

Après avoir changé le pays dans Analyse de marque, enregistrez les modifications puis sélectionnez Analyser la marque. Rouvrez Connaître votre concurrent ou Visibilité dans la recherche IA pour actualiser ces données.

Les codes pays utilisent deux lettres, comme US, IN, GB ou DE.

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. 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.

13. 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.

14. 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.

15. 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.

16. 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.