Set up your workspace, run your first GEO scan, and generate your first post
This guide walks you through onboarding, your first GEO scan, and, as a second part, connecting GitHub and generating your first post in Studio.
Before you begin: you need a public website for the brand you want to track. For the Studio part you also need a GitHub account with access to at least one repository.
Enter your workspace Name (for example “Acme Inc”). The Slug fills in automatically and becomes your workspace URL: app.usenotra.com/acme-inc. You can edit the slug before continuing.
2
Website
Enter your website (for example acme.com). Notra reads it in the background to pick up your brand voice and creates your default brand identity from it. The field is optional, but without it the next step cannot suggest prompts and you will type your brand name by hand.
3
Where did you hear about Notra?
Optional. Pick a source or choose Other and tell us.
4
Continue
Click Continue. Your workspace and default brand identity are created.
The slug cannot be changed after onboarding, so choose something that represents your company or team.
Notra asks ChatGPT, Claude, Gemini and Perplexity what your buyers ask them, then checks if you come up. This step decides what to look for in the answers.
1
Let Notra read your website
Your website is prefilled from step 1. Notra reads it, which takes about 20 seconds, and suggests your brand name, aliases and a starter set of prompts. If the site cannot be read, check the address or type your brand name below.
2
Confirm your brand name
The Brand name field is what Notra looks for in AI answers, usually the name on your homepage. Adjust it if needed.Below the field you will see how many questions were pulled from your site. You can edit them later under Prompts.
3
Continue
Click Continue to save the brand and prompts. Skip for now takes you straight to plan selection; you can set tracking up later from GEO Settings.
When AI recommends someone instead of you, who is it? This step chooses the brands you are measured against.
1
Review suggestions
Notra suggests other companies in your field based on your domain. Click a suggestion to add it, Show more to see the full list, or Add all.
2
Search for a brand
Use Add a brand to search for any competitor that is not suggested. You can track up to 25 competitors.
3
Start tracking
Click Start tracking. Notra saves your competitors and runs your first scan in the background. If your workspace does not have a plan with AI answers yet, the button reads Continue and you run the first scan after choosing a plan.
Pick Starter, Growth or Scale, monthly or yearly. Each plan can add zero data retention for the AI providers Notra scans with. If you are eligible for a free trial, the plan card says so. After checkout you land in your workspace at app.usenotra.com/{slug}.See Billing for what each plan includes.
Click Overview under Visibility. The header reads “How AI engines talk about your brand”. If tracking is not set up yet, click Set up tracking to add your brand name and the engines to track.
2
Run Scan
Click Run Scan (or press R). Notra sends every tracked prompt to every enabled model and checks each answer for your brand, aliases and competitors. The button shows a spinner while the scan runs; results fill in as they arrive.
3
Read the results
The Overview has three tabs:
Visibility: how often you are mentioned, per engine and over time, plus share of voice against your competitors
Prompts: results per prompt, so you can see which questions you win and which you lose
Journeys: how AI-driven visitors move through your site once Traffic is connected
Use the range picker in the header to change the time window.
Scans run automatically on the schedule set in GEO Settings (every day by default). Manual scans always work.
Company name and Aliases: other spellings, product names, or the bare domain that should count as a mention
Scan schedule: Every day, Every 48 hours, Every 3 days, Every week, Every 2 weeks, or Every 30 days
Languages: the languages your prompts are scanned in. English is on by default
Models: each enabled provider runs on every prompt
Open Prompts under Visibility. Click Add prompt to add a question, Import CSV to bulk import, or accept suggestions. If you connect Google Search Console, the queries you already rank for become prompt suggestions.
Open Competitors under Visibility to add or remove brands and mark them as direct (sells what you sell) or indirect (solves the same problem differently). Click a competitor to see the prompts where they are recommended.
Install the @usenotra/geo package in your Next.js, Nuxt, TanStack Start, Astro, SvelteKit or Netlify site and set NOTRA_GEO_TOKEN to see AI crawlers and referrals visiting your site.
Agent Readiness
Run a public scan of your website and get a 0 to 100 score with a Must do / Should do checklist.
Content Gaps and Write
See which questions engines answer without mentioning you, and write an article to close the gap.
Click Integrations in the sidebar and open GitHub.
2
Install the Notra GitHub App
Click Connect and install the Notra GitHub App on your GitHub account or organization. Grant it access to the repositories you want Notra to read.
3
Select repositories
Back in Notra, pick the repositories granted to the app. Each one becomes a source for content generation.
Integrations connected earlier with a personal access token keep working and are listed as legacy integrations. New connections go through the GitHub App.
Click Brand Identity in the sidebar. If you added a website during onboarding, Notra has already analyzed it (Scraping, Extracting, Saving) and filled in the Company Info tab.
1
Check the company profile
Company name, Website and Description.
2
Set tone and language
Pick a tone (Conversational, Professional, Casual or Formal), add custom tone notes if you like, pick the Language content should be written in, and add Custom Instructions such as phrases to avoid or features to always mention.
3
Describe your audience
Fill in Who are you writing for? with their role, interests and pain points. Developer audiences get PR links; non-developer audiences do not.
Changes auto-save. See Brand Voice for how each field changes the output.
Click New post at the top of the sidebar, or open Content and click the create button.
2
Choose formats
Pick one or more formats: Changelog entry, Blog post, LinkedIn post, Tweet or Image.
3
Choose activity
Select a timeframe and which data to include: Pull Requests, Commits and Releases from your repositories, plus Linear issues if connected. You can search and pick individual items.
4
Choose a brand identity
Pick the identity the post should be written in, then generate.
5
Review in Content
Generated posts appear in Content, grouped into collections. Open a post to edit it in the editor, use the chat panel to refine it, and click Publish when it is ready. Tweets and LinkedIn posts can be posted directly to connected X and LinkedIn accounts.
Every generated post starts as a Draft so you can review it before it goes anywhere.
Open Schedules under Automation and create a schedule:
Frequency: Daily, Weekly (pick a day of the week) or Monthly (pick a day of the month)
Time: hour and minute in UTC
Repositories to include
Output type and brand identity
Lookback window: Current day, Yesterday, Last 7 days, Last 14 days or Last 30 days
Auto-publish to skip the draft stage
Use Run now on a schedule to test it without waiting.
Open Events under Automation and create a trigger:
Source: GitHub webhook
Event types: Release, Push, or both (pre-releases can be included)
Repositories to listen on
Output type and brand identity
Content is generated as soon as the event arrives.
Open Iris under Automation. Iris watches what you ship and drafts changelogs, blog posts with images and social posts, then asks you on Slack before anything goes live. It needs the Slack integration.
Check the address. Notra needs a publicly reachable site.
Type your brand name by hand and continue. You can add prompts later under Prompts.
The Overview says AI visibility is not set up yet
Click Set up tracking and add your company name and at least one model in GEO Settings.
Make sure your plan includes AI answers. Onboarding with Skip for now leaves tracking unset until you finish Settings.
My scan finished but I see no mentions
Add Aliases in GEO Settings for other spellings, product names, or your bare domain.
Check the Prompts tab on the Overview to see the actual answers per engine.
Content Gaps lists the prompts where you are missing, which is the starting point for new content.
No content is being generated
Verify the schedule or trigger is enabled.
Check that the selected repositories have activity inside the lookback window.
The generator skips a run when every change is internal-only (dependency bumps, formatting, tests). Widen the lookback window or include more repositories.
Generated content does not sound like us
Review Brand Identity: tone, custom instructions and audience.
Add real posts under References so the AI can match your style.
Choose Re-analyze from the identity menu if your website branding changed.