Create a project for a client site, finish its setup, and manage its pages, integrations, refresh schedules, memory and saved sign-ins.
A Project is one website you track inside a Company. It holds the site’s domain, its competitors, your brand names, the topics you target and the market you sell into, and its settings decide which pages and tools are switched on for it. Tasks, keywords, reports, opportunities, content and integrations all belong to a project.Most work in Visibility happens inside one: an Agent can only work on the projects it is assigned to, and every report reads its numbers against the project’s domain.
Click Projects in the sidebar. The page is headed Projects, with a New project button at the top right, a count such as “3 projects”, and a Show archived / Hide archived toggle.Each project is a card showing its logo or initials, its name and domain, and six metrics: sessions, clicks, AI vis. (%), keywords, open tasks and opps. A metric reads ”—” when the source behind it is not connected yet. Archived projects are dimmed and carry an Archived label.
The Projects page, one card per client site with its headline metrics.
The Projects row in the sidebar also expands into a list of your projects, with a + (Add project) that opens the same dialog. If you have no projects yet you see “No projects yet — Add a client site to start tracking SEO work.”
Any member of the company can create a project. Only the name is required.
1
Open the New project dialog
Click New project on the Projects page, the + beside Projects in the sidebar, New project in the project switcher, or press Ctrl/⌘ K and choose the new-project action.
2
Name the project
Type a Project name (up to 200 characters). Pressing Enter here creates the project straight away.
3
Describe it
The description is optional but worth writing: agents working on this project’s tasks receive the name and description as context. Write it like a brief for a new teammate — audience, tone, goals and constraints. Up to 2,000 characters.
4
Enter your domain
Under SEO Configuration, type Your domain — either a bare host such as yourbrand.com or an https:// address. Read the notice beside it: this is a one-time setting. An http:// address is rejected with “Use https:// — an http:// address isn’t accepted”.
5
Add competitor domains
Type a competitor domain and press Enter, or paste a comma-separated list. Each entry is checked for being a real domain, and duplicates are dropped. You can add up to 50.
6
Assign people and agents
Under Assign people & agents, use Search people and agents… to pick teammates and agents, or use the Assign all agents row. Agents only work on the projects they are assigned to.
7
Create it
Click Create project. You land on the new project’s Overview.
Every feature is switched on for a new project; narrow it down later in Settings → Features. The dialog keeps your draft across a page refresh, and Discard clears it.
Assigning people records who is responsible for the project. It does not hide the project from your other teammates. Up to 50 people can be assigned.
Your plan sets how many projects a company can have: 3 on Starter and 6 on Growth, counting only projects that are not archived. Past that you see “You’ve reached your plan’s project limit — This plan allows up to N projects. Upgrade to add more.” See Billing and subscriptions. A company that has not finished onboarding is asked to “Finish setting up the workspace before creating projects.”
Where this is available on your workspace, the sparkle button beside the description writes it for you from the site itself.
1
Fill in the name and domain
The sparkle button stays disabled until the project has a name and a valid domain; its tooltip names whatever is still missing.
2
Click the sparkle button
Its label is Write this description with AI.
3
Confirm
The dialog asks “Write the description with AI?” and explains that it will read your domain and summarise it. It warns you if this would replace text you have already written. Click Generate.
4
Wait, then edit
You see “Reading your domain… This takes a few seconds — please don’t close this window.” The dialog can’t be closed while it works. The finished text lands in the description field and is yours to edit before you create the project.
If the site can’t be read you see, against the domain field, “We couldn’t read this domain, so the description couldn’t be generated. Check it’s correct and publicly reachable.” A generated description is capped at 1,200 characters, and generating them is rate-limited per person.
The domain is what every number in the project is measured against, so it locks as soon as there is anything to measure.
While no data has been collected, the Domain field in Settings → General is editable and shows “Set this carefully — it’s a one-time setting”.
Once any rankings, AI answers, opportunities, backlinks or traffic exist, the field turns read-only: “The domain is fixed for this project — Data has already been collected… To track a different site, create a new project — this one keeps its history.”
Tidying the same host — fixing the capitalisation, adding or dropping www., adding https:// — is not treated as a change. A rebrand or a genuinely different site means a new project, and the old one keeps its history.
Open a project and the company sidebar collapses to an icon rail, with a second sidebar for the project beside it. At the top are a back arrow (All projects) and a project switcher listing your projects, All projects and New project. Switching projects from that dropdown keeps you on the same section.
Section
What it is
Overview
The project’s report summaries and its setup checklist. Always present.
The Reports group appears while the Overview report feature is on, and each report page inside it follows its own toggle — Tasks Overview and Custom Dashboards are always available. Opportunities, Content and Link building appear when their toggles are on.
The Overview is the project’s front page: the project name, a date filter, and stacked report summaries — Tasks and Site authority side by side, then Keyword ranking, AI visibility and Organic traffic. Each section carries a button through to the full report and a “Last checked” or “Last run” stamp.
The project Overview: the setup bar, then a summary of each enabled report.
Use the date filter in the header to choose 7d, 30d, 90d, 1y or Custom (a start and end date up to 365 days apart). The default is 30d. Every section follows the same window, and your choice is kept in the page address, so a link shares the same view.Site authority shows Domain Rating, a 0–100 score provided by Ahrefs, as a ring for your domain next to the same score for each competitor domain. Unrated means the score is unknown, not zero.
Until a project is fully set up, a one-line bar under the header shows your progress, for example “2/6”, with either the one thing that is missing or “4 things left to set up”.
1
Open the checklist
Click the bar. It opens “Finish setting up this project — Each one turns on something the reports and agents can use.”
2
Work through the outstanding rows
Each row says what it unlocks and links straight to where it is fixed: Set the project’s domain, Add your brand names and Add competitor domains go to Settings → General; Add keywords to track goes to the Keyword Ranking page; Connect Search Console and Connect Google Analytics go to Settings → Integrations.
3
Finish
When every item is done the bar disappears.
Only items that serve a feature you have switched on are listed — a project with AI visibility off is never asked for brand names.
Open Settings in the project sidebar. The header reads the project name followed by Settings, with a tab row: General, Features, Integrations, Schedules, Memory and Sign-ins. Each tab has its own address, so you can link straight to one.
Tab
Who can change it
General, Features, Memory, Sign-ins, assigned agents, archive and delete
The Manage company permission (Admin by default). Sign-ins is admins only.
Integrations
The Manage integrations permission (Admin and Manager by default).
Schedules
Any member can view, edit and run them.
Members without the permission still see the settings, read-only: General shows a Details card with the note “Only workspace admins can change these — ask one if something here needs updating.” See Team management for roles and permissions.
Settings → General, with the SEO + GEO block for competitors, brand names, topics and location.
The General form saves with Save changes and applies immediately (“Project saved”).
Field
What it is for
Name and Description
How the project appears, and the standing brief every agent receives with its tasks.
Domain
The site being optimised. Editable until data has been collected, then fixed (see above).
Target date
A calendar date you are working towards, shown on the project.
Logo
Hover the logo square, click the camera button and pick an image. It saves at once (“Logo updated”); Remove clears it. Square works best — it is resized to a 160px square before saving.
The SEO + GEO block holds the inputs that drive both SEO workflows and AI-visibility tracking:
Competitor domains — press Enter or type a comma to add one; each is validated. Up to 50. Used for share of voice, AI-visibility comparisons, the Site authority card and the competitor gap detectors.
Brand names — press Enter to add. Commas are kept, so “Smith, Jones & Co” stays one name. These are the names AI-visibility checks look for in assistant answers. Up to 50, each up to 200 characters.
Suggested competitors — pills for domains the AI assistants named in this project’s answers, six at a time with Show N more. Click one to add it. Directories are listed separately with the note that they are better as citation targets than competitors, and adding one removes it from your AI Citations tab.
Topics — the subject areas the project targets, used by AI visibility. Up to 50.
Location — the market you are tracking, either a country or City, Region, Country.
A brand name of three characters or fewer, or an everyday word such as “store”, “app” or “design”, shows an amber warning. Such names match unrelated text in assistant answers and will overstate your visibility. Use the name people actually search for.
Below the form, the Agents card is the project’s agent access list: only the agents ticked here can work on this project, and an empty list means none can. Tick them in the multi-select or use Assign all agents, then click Save (“Assigned agents updated”). Removing an agent revokes its access immediately; assigning it a task on this project grants access again. This is enforced everywhere, not just in the interface.
Features decides which pages and tools this project has. Toggles save instantly and the project sidebar updates to match.
Group
Toggles
—
Overview report — the Overview’s report sections and the Reports group.
Pages
Keywords, AI visibility, Organic traffic, Opportunities. Each enabled page appears in this project’s sidebar.
Workflows
Content, with sub-toggles Planner, Tasks and Database; Link building, with Activities, Tasks and Database.
Turning a page off hides it and its Overview section but deletes nothing — switch it back on any time and the data is still there. Overview, Tasks, Custom Dashboards and Settings can’t be hidden, and WordPress has no toggle: it is available whenever a site is connected under Integrations.
Integrations is where you connect the data sources this project uses: Google Analytics, Google Search Console and WordPress. Each card shows a status badge (Connected, Choose property, Choose site, Reconnect) and the connected property or site name. Buttons you don’t have permission to use stay visible but disabled, with a tooltip explaining why.
Google Analytics — click Connect, approve read access on Google’s screen, then click Choose property and pick a GA4 property. Use Change property to repoint it or Disconnect to remove it.
Google Search Console — click Connect, approve on Google’s screen, then click Choose site and pick a verified site. If the Google account has none, the picker says “No verified sites on this Google account.”
WordPress — click Connect, install the Agentic SEO for Visibility plugin on your site, then click Generate pairing code and paste the code into the plugin. Once paired, the card shows the site name and reminds you that publish requests are approved in Inbox → Approvals.
Only the teammate whose Google account made a connection can change its property or site; anyone with Manage integrations can disconnect and reconnect with their own account. If access is lost, the badge turns red with Reconnect and a plain-English reason. Organic traffic renders with either Google Analytics or Search Console alone — neither one needs the other.Full setup instructions live in Integrations; publishing is covered in Content and WordPress and approvals in Inbox and approvals.
Bringing your own DataForSEO key is a company-wide choice, not a project one. It lives under Company settings → AI clients → Data providers. See Credits and BYOK.
Schedules is where you decide how often the platform refreshes each SEO data source. All times are in UTC. The tab has two inner views: Overview, with a card per job, and History.
Settings → Schedules: a card per data source with its schedule, credit estimate and Run now.
There are seven jobs:
Job
What it refreshes
Keyword Rankings
SERP positions for tracked keywords.
AI Visibility
AI-assistant visibility checks. Weekly minimum.
Organic Traffic
Organic sessions from Google Analytics.
Content Opportunities
Content gaps from Search Console.
Competitor Content Gaps
Content your competitors cover and you don’t.
Competitor Link Gaps
Links your competitors have and you don’t.
AI Citation Gaps
Sources AI assistants cite that don’t mention you.
Each card shows the job’s title, an Active or Inactive badge, the schedule in words (“Every Monday at 09:00 UTC” or “Not scheduled”), Next and Last times, an estimate such as “~55 Credits est. / run”, and the outcome of the last run. Active cards also carry Run now and Edit. An Inactive card lists what the job still needs before it can run — a project domain, a tracked keyword, a connected property, a competitor — each with a link to fix it.New projects start with Keyword Rankings, Content Opportunities and the three gap detectors refreshing weekly, and Organic Traffic twice a day. If a card reads Not scheduled, click Edit to give it a day and time.
On an Active card click Edit. The dialog is headed with the job name and “How often the platform refreshes this data source.”
2
Pick a frequency
Choose Off, Hourly, Daily, Weekly, Monthly or Custom. AI Visibility and the three gap detectors are not offered Hourly or Daily; their dialog adds “This source runs weekly at most.”
3
Set the time
Pick an hour (00–23) and a minute (:00, :15, :30 or :45) in UTC, plus a day of the week for Weekly or a day of the month (1–28) for Monthly. A summary line previews the result, for example “Every Monday at 09:00”.
4
Save
Click Save. The card shows the new schedule and its next run.
Find the job — it must be Active — and read the “~N Credits est. / run” line, which is costed against today’s tracked keywords and enabled prompts.
2
Run it
Click Run now and confirm: “This runs immediately and will cost ~N Credits, debited from this company’s balance right away.”
3
Wait for the result
The button reads Running… until it finishes — up to a minute or two for AI Visibility — then you get a toast telling you the run succeeded or why it failed, and the card’s last-run line updates.
Only one run per job can be in flight at a time; a second attempt is refused with “a run is already in progress for this job — try again once it finishes.” Manual runs are rate-limited per job over a short window, and the message tells you the allowance. A manual run also clears an automatic pause caused by repeated failures.When the latest run failed, the card offers Retry instead — the same action, beside the error. For the full record, open History and expand a job: each row shows Succeeded or Failed, a Manual or Scheduled badge, when it ran, what it cost in credits, and Show error on failures. Load more pages further back, 20 rows at a time and up to 100 per job. Jobs that have never run read “No runs recorded yet.”
Project memory is what every agent working on this project knows about it. It is injected into every run on this project and never into another project’s work.Five sections carry the standing context — Voice & Taste, Audience, What Works, Constraints and Open Threads. Click Edit on one, write, and click Save; saving locks that section so agents can’t rewrite it.Below them, Recorded facts are short dated notes, each with a kind pill (Fact, Preference, Constraint, Playbook or In flight) and a line saying whether it was recorded by an agent or added by a person. Type into “Add a note every agent on this project should know…” and press Enter or click Add. The × on any note retires it, whether an agent or a person wrote it.Editing needs Manage company; everyone else reads. Agents have their own separate memories, and company-wide facts belong in Company settings — see Agents for how the three fit together.
Some work needs an agent to be signed in to a client’s site. Saving a sign-in here captures the session once, so agents start already signed in and never see the password.
1
Open a browser
Go to Settings → Sign-ins (admins only). Enter the Sign-in page URL, for example https://example.com/wp-login.php, and click Open a browser.
2
Sign in yourself
Sign in inside the embedded browser, exactly as you would normally.
3
Check the domain and save
The Domain field is prefilled from the URL and editable — make sure it matches where the site keeps you signed in. Click Save this sign-in, or Discard to throw it away. You then see “Saved — Agents working on this project can now use the sign-in.”
Stored for this project lists each saved domain with its cookie count, expiry (or “session only”), and when it was last used. Expired entries offer Sign in again, and the trash icon forgets one. Only the cookies for the domain you enter are saved, they are stored encrypted, and they are handed to an agent’s browser only while it works on this project.
Never put a real password into the Login Email/Password columns of a Link building import. Saved sign-ins are the right place for credentials.
Both live in the red-bordered Manage card at the bottom of Settings → General, and both need Manage company.
1
Archive
Click Archive. The project disappears from the default Projects list but stays reachable through Show archived, and the button becomes Unarchive.
2
Unarchive
Open the archived project and click Unarchive to put it back in the active list.
3
Delete
Click Delete, read “Delete this project? — it will be permanently removed. This can’t be undone.”, and confirm with Delete project. You return to the Projects list.
Archived projects don’t count against your plan’s project allowance, and their schedules stop being Active. Deleting is permanent — archive instead if there is any chance you will want the history back.