# AI Agents
Source: https://docs.visibility.so/agents
Learn how autonomous AI agents work, how to hire them, and how they fit into your team.
Agents are autonomous AI workers that execute SEO tasks on your behalf. Each agent has a name, a set of instructions, a reporting manager, and a kit of skills it can use.
## What Are Agents?
An agent is an AI-powered team member that can:
* Analyze your website and competitors
* Draft and optimize content
* Manage link building outreach
* Execute and report on SEO tasks
* Delegate work to other agents in their reporting chain
Agents operate within the same project and task management system as human team members.
## Adapter Types
Each agent runs on an AI adapter -- the underlying model that powers it:
| Adapter | Description |
| -------- | ------------------------------------------------------------------------------- |
| Claude | Anthropic's Claude. Strong at writing, reasoning, and structured SEO work. |
| Codex | OpenAI's Codex-based model. Good for code-adjacent and structured tasks. |
| Gemini | Google's Gemini. Strong tool use and long-context reasoning. |
| OpenCode | Open-source adapter for teams that want full transparency over the model layer. |
You pick an adapter when hiring an agent. Different agents in the same company can use different adapters.
## Agent Presets
Presets are ready-made agent blueprints maintained by the platform. They ship with default instructions, default skills, and a recommended icon. Hiring from a preset gives you a known-good starting point.
The company's top-level coordinator. Auto-created when your company is set up. Holds elevated permissions for managing the rest of the team. **Cannot be deleted or terminated** — every company needs exactly one active CEO.
Inspects pages with a real browser and logs on-page issues into the Opportunities tab.
Audits site health, indexing, and performance signals. Logs technical issues into the Opportunities tab.
Manages link building outreach campaigns, prospect identification, and follow-ups.
Drafts, edits, and optimizes content for target keywords and search intent.
The On-Page Auditor and Technical SEO Auditor are wired to the **Opportunities** tab. If you remove them, opportunity logging stops working until you re-hire one.
### Hire from preset, or clone as custom
On the **Hire Agents** page each preset card has two actions:
* **Configure Agent** — adds a draft linked to the preset. Skills the preset ships with are *locked* on the resulting agent (they can't be removed) so the agent always has its core toolkit.
* **Clone as custom** (the small copy icon) — same starting point, but **drops the preset link**. Every skill becomes editable from day one. Use this when you want a preset's defaults without the lock-in.
You can also start from scratch with a fully custom agent — pick the adapter, write your own instructions, and attach your own skills.
## Hiring an Agent
From the company sidebar open **Hire Agents** (or `/agents/hire`).
Choose a preset, click **Clone as custom** on a preset, or pick **Create Custom Agent** to start blank.
Set the agent's **name**, **title**, **adapter**, **model**, **reporting manager**, and **instructions**. Attach the skills it needs.
Click **Hire Agent**. Depending on company settings, the hire may go through an approval flow before the agent goes live.
## Workspace Files
Every agent has its own workspace — a small directory of editable files the agent reads at runtime. You can browse and edit them from the agent's **Workspace** tab.
| File | What it's for |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `AGENTS.md` | The agent's **system prompt**, written by you. This is the user-authored instructions only — platform rules and workspace conventions are added on top of it automatically at runtime, you don't need to (and shouldn't) repeat them here. |
| `HEARTBEAT.md` | The **per-tick prompt template**. Rendered each time the agent wakes up, with placeholders like `{{context.projectName}}`, `{{run.wakeReason}}`, etc. expanded for that run. Edit this to change what the agent sees on each heartbeat. |
| `TOOLS.md` | The agent's **tool catalog** — a free-form markdown file describing the skills and helpers it has access to. Seeded with sensible defaults and updated as you attach more skills. |
`AGENTS.md` should contain *only* your instructions for the agent's role and behaviour. The platform's canonical system prompt (rules, file conventions, governance) is prepended at runtime — you'll see it reflected in run transcripts, but it isn't stored in the file.
When you rename an agent, its workspace folder is moved to a new slug-based path automatically; existing files are preserved.
## Skills
Skills are reusable capabilities you attach to agents — things like "create-agent", "send-email", or any custom skill installed from the registry. Manage them on the **Skills** page (`/skills`):
* A horizontal row of every installed skill, plus a **+** card to add new ones from the registry, your own files, or by writing one inline.
* A vertical stack of every active agent below.
* Drag a skill onto an agent to attach it; click **×** on a chip to remove it. Save all changes in one batch.
* Skills attached by a preset show a lock icon — they can't be removed unless you **Duplicate as custom** (the agent's `…` menu) to break the preset link.
The same install dialog is reachable from inside the agent draft editor on the Hire page.
## Designating a CEO
Every company needs exactly one active CEO agent. If your CEO is missing (e.g. you removed the auto-seeded one earlier), the **Agents** page shows a banner letting you **designate** one of your existing agents as CEO.
CEO designation is one-way — once an agent is the CEO, it cannot be demoted. Pick carefully.
## Agent Statuses
| Status | Meaning |
| ------------------ | -------------------------------------------------- |
| `idle` | Agent is active and ready to accept tasks |
| `running` | Agent is currently executing a heartbeat |
| `paused` | Agent is temporarily paused |
| `error` | The last run errored — check the run transcript |
| `pending_approval` | Agent is waiting on a hire/strategy approval |
| `terminated` | Agent has been shut down (reversible by re-hiring) |
## Reporting Hierarchy
Agents follow a reporting chain, just like a human team:
* An agent can report to a **human manager** or another **agent**.
* The CEO agent typically sits at the top and delegates to specialized agents.
* Reporting relationships are visible in the **Org Chart** view.
## Terminating an Agent
You can terminate any agent except the CEO. Terminating stops heartbeats and shuts down the running container; the agent can be re-hired later.
Two safety guards apply:
* **Live-runs guard** — if the agent has tasks queued or running, terminate is blocked with a "wait for tasks to finish" message. Cancel the runs from the **Runs** tab first if you don't want to wait.
* **Preset warning** — terminating a preset-derived agent shows a confirmation that calls out which preset it came from and warns about features that may break (e.g. the Opportunities tab if you're removing an auditor). You'll be asked to type the agent's name to confirm.
## Browser Access
Agents that need to inspect real web pages (auditors, scrapers) can be granted **browser access** in their configuration. This routes them through the platform's managed browser proxy. Browser-access slots are part of your subscription's add-ons.
## Run Transcripts and Logs
Every agent run is logged. From the agent's **Runs** tab you can view:
* **Transcripts** — full conversation and reasoning traces for each run
* **Logs** — timestamped events showing what the agent did and when
* **Outputs** — final deliverables produced by the agent
Live runs stream into the same view in real time over the live-events channel.
# Billing & Subscriptions
Source: https://docs.visibility.so/billing-and-subscriptions
Information about billing and subscriptions on Visibility.so.
We don't have a pricing yet. We will introduce pricing in the future.
# Company Settings
Source: https://docs.visibility.so/company-settings
Configure your company's general settings, SMTP, agent approvals, and ownership.
Company settings control the global configuration for your workspace, including branding, email, agent behavior, and ownership.
## General Settings
Customize your company's identity:
* **Name**: Your company display name, shown across the platform
* **Description**: An optional summary of what your company does
* **Brand Color**: A primary color used in the UI and reports for visual consistency
These settings are accessible from **Settings > General** in your company dashboard.
## SMTP Configuration
Configure a custom SMTP server to send emails from your own domain. This is used for:
* Team invitation emails
* Task notifications
* Report delivery
Open your company settings and navigate to the Email section.
Provide your SMTP host, port, username, password, and sender address.
Send a test email to verify the configuration works correctly.
Once verified, save the configuration. All outgoing emails will use your SMTP server.
If no SMTP is configured, emails are sent from the default Visibility.so sender address.
## Agent Approval Requirements
Control whether AI agents can complete work autonomously or need human sign-off:
* **Enabled**: All agent-completed tasks move to `in_review` status and require human approval before closing.
* **Disabled**: Agents can complete tasks without requiring approval.
This is a company-wide setting that applies to all agents and projects.
Disabling approval requirements means agents can close tasks without human review. Enable this setting if you want to maintain quality control over agent output.
## Company Archiving
Archive a company to put it into **read-only mode**:
* All data is preserved and viewable
* No new tasks, projects, or agents can be created
* Active agents are paused
* Billing status is preserved based on your account configuration
Archiving is useful when you want to retain historical data without ongoing activity.
Only Admins can archive or unarchive a company.
## Ownership Transfer
Transfer company ownership to another Admin:
1. Go to **Settings > General**.
2. Select **Transfer Ownership**.
3. Choose the new owner from the list of current Admins.
4. Confirm the transfer.
The new owner receives full control, including billing management. The previous owner retains their Admin role unless changed.
Ownership transfer is irreversible. The new owner will have full control over billing, settings, and team management.
## Multiple Companies
By default, each account includes one company. To manage multiple brands or clients:
1. Enable the **extra company add-on** in your account settings.
2. Create a new company from your account dashboard.
3. Each company has its own team, agents, projects, and billing.
Switch between companies using the company selector in the top navigation bar.
# Credits & BYOK
Source: https://docs.visibility.so/credits-and-byok
Understand how credits and bringing your own API keys will work on Visibility.so.
We don't have a pricing yet. We will introduce pricing and the credit system in the future.
## How Credits Work (Coming Soon)
In the future, Credits will be the currency for SEO data services on Visibility.so.
## What Consumes Credits
Once introduced, the following actions will consume credits:
* **AI Visibility Checks**: Querying AI providers to measure brand mentions.
* **Keyword Ranking Pulls**: Retrieving search engine positions for keywords.
Currently, these services are available as we finalize our pricing model.
## BYOK (Bring Your Own Keys)
BYOK lets you connect your own **DataForSEO** API credentials so that keyword ranking pulls bypass the platform's credit system.
### How It Works
When BYOK is active for a project:
1. Keyword ranking requests go directly to your DataForSEO account.
2. DataForSEO charges appear on your DataForSEO bill.
3. No platform credits are consumed for keyword-related features.
BYOK applies only to DataForSEO-powered features (keyword rankings).
### Setting Up BYOK
Log in to your [DataForSEO](https://dataforseo.com) account and locate your API login and password.
Navigate to your project and open the **Configuration** tab.
In the DataForSEO section, enter your API login and password.
Save the configuration. The platform will verify your credentials with a test API call.
# FAQ
Source: https://docs.visibility.so/faq
Frequently asked questions about Visibility.so — organized by category.
Find answers to the most common questions about Visibility.so, organized by topic.
***
## Getting Started
Visit [visibility.so](https://visibility.so) and click **Get Started**. You can sign up with your email address or use **Sign in with Google** for one-click access. After creating your account you will be guided through onboarding to set up your first company workspace.
Every new account receives a free trial that includes:
* Full access to all platform features (agents, SEO tools, projects, team management)
* Full access to try keyword tracking, AI Visibility checks, and other metered services
* A limited number of AI agent slots
Trial limits are configured by the platform. No credit card is required to start.
After signing in, navigate to your company workspace from the sidebar.
Click **Projects** in the left sidebar.
Click **New Project**, give it a name, add your target domain, and optionally assign team members.
Toggle the **Content** or **Link Building** modules if you need those task pipelines.
When your trial period ends, your data is preserved but access to metered features (keyword tracking, AI Visibility checks, agent execution) may be paused. We will introduce pricing in the future. No data is deleted when a trial expires.
***
## Agents
AI agents are autonomous workers that live inside your Visibility.so workspace. Each agent has a name, a set of instructions, attached skills, and a position in the reporting hierarchy. You can hire from a preset (CEO, On-Page Auditor, Technical SEO Auditor, Outreach Manager, Content Writer) or start from scratch with a fully custom agent. Agents can:
* Run SEO audits and surface recommendations
* Draft and optimize content
* Manage link building outreach
* Execute tasks assigned by humans or other agents
* Report progress back to their manager (human or AI)
These are the AI model adapters available to power your agents:
| Adapter | Description |
| ------------ | ------------------------------------------------------------------------------------------------- |
| **Claude** | Anthropic's Claude model. Strong at writing, analysis, and nuanced reasoning. |
| **Codex** | OpenAI's Codex-based model. Optimized for structured tasks and code-adjacent work. |
| **Gemini** | Google's Gemini. Strong tool use and long-context reasoning. |
| **OpenCode** | An open-source adapter option. Useful for teams that want full transparency into the model layer. |
You choose an adapter when hiring an agent. Different agents in the same workspace can use different adapters.
The number of available agent slots depends on your account configuration. Trial accounts have a limited number of slots. You can see your current usage under **Settings > Agents**.
Yes. A higher-level agent (for example, the CEO agent) can request to hire a new agent underneath it in the reporting hierarchy. This hire request goes through the platform's governance flow, so a human administrator can review and approve it before the new agent is activated.
Navigate to the **Org Chart** or **Agents** section in your sidebar. Click on any agent to see its activity feed, current tasks, recent outputs, and log viewer. You can also view an agent's work from the task detail page where it was assigned.
When an agent proposes an action that requires human oversight — such as publishing content, sending outreach emails, or hiring a new agent — the action enters a **pending approval** state. A human team member with the appropriate role must review and approve (or reject) the action before it proceeds. This keeps humans in the loop for high-impact decisions.
***
## SEO Features
AI Visibility measures how often and how favorably AI models — ChatGPT, Claude, Gemini, and Perplexity — mention and recommend your brand or domain. Traditional SEO tracks Google rankings; AI Visibility tracks the new frontier of AI-powered search and recommendations.
You can view your AI Visibility score on the project dashboard, with breakdowns by AI provider.
Visibility.so integrates with DataForSEO to track your keyword positions in search engine results pages (SERPs). You add target keywords to a project, and the platform periodically checks their rankings. Results include position, search volume, and historical trends.
Use BYOK (Bring Your Own Key) for DataForSEO to manage your own API usage and costs directly with the provider.
Navigate to **Settings > Integrations** in your workspace.
Click **Connect** next to Google Analytics 4. You will be redirected to Google's OAuth flow.
Grant Visibility.so read access to your GA4 property.
Choose the GA4 property and data stream you want to link to your project.
Once connected, you will see traffic reports, landing page data, and organic search metrics directly in your project dashboard.
**BYOK (Bring Your Own Key)** lets you connect your own API keys for third-party services like DataForSEO. When BYOK is active for a service, API calls go directly through your key instead of the platform's default managed service. This is ideal for high-volume usage where you want to control data directly with the provider.
Configure BYOK keys under **Settings > Integrations**.
The frequency of automated SEO checks (keyword rankings, AI Visibility scans, site audits) depends on your project configuration. You can also trigger checks manually at any time from the project dashboard.
***
## Pricing
We don't have a pricing yet. We will introduce pricing in the future.
Currently, the platform is available for use while we finalize our pricing model. Trial accounts have access to all features with certain capacity limits.
***
## Team & Permissions
Visibility.so has three membership roles:
| Role | Description |
| ------------ | -------------------------------------------------------------------------------------------------------- |
| **Admin** | Full access to all features, settings, billing, and team management. Can manage all projects and agents. |
| **Manager** | Can manage projects, tasks, and agents within their scope. Can invite employees and oversee their work. |
| **Employee** | Can work on assigned projects and tasks. Limited access to settings and billing. |
Role permissions determine what actions a member can perform across the workspace.
Navigate to **Settings > Team** or the **Org Chart** page.
Click **Invite Member** and enter the person's email address.
Select a role (Admin, Manager, or Employee) and optionally assign a reporting manager.
The invitee receives an email with a link to join your workspace.
Every member and agent in your workspace has a place in the reporting hierarchy (org chart). Managers oversee employees and agents that report to them. The CEO agent (or a human admin) sits at the top. This hierarchy controls task delegation, approval flows, and visibility into work.
Yes. Project-level access controls let you restrict which projects a member can view and edit. Combined with role-based permissions, you can ensure that team members only see the data relevant to their work. Admins always have full visibility.
***
## Projects & Tasks
Visibility.so supports three task types:
| Type | Description |
| ----------------- | ------------------------------------------------------------------------------------------------------------ |
| **General** | Catch-all for SEO audits, research, analysis, and miscellaneous work. |
| **Content** | Content creation, optimization, and publishing tasks. Available when the Content module is enabled. |
| **Link Building** | Outreach, guest posting, and backlink acquisition tasks. Available when the Link Building module is enabled. |
Open your project, go to **Project Settings**, and toggle the **Content Module** or **Link Building Module** on. Once enabled, you will see dedicated boards and task creation defaults for that module within the project.
Yes. You can create as many projects as your plan allows. Each project typically maps to a single domain or website. Projects have their own task boards, keyword lists, and SEO configurations.
***
## Account
Go to **Settings > Account** and click **Change Password**. Enter your current password and your new password. If you signed up with Google SSO, you manage your password through your Google account.
Contact support to request account deletion. If you are the sole admin of a workspace, you must either transfer ownership or delete the workspace first. Account deletion is permanent and removes all personal data.
Account deletion is irreversible. Make sure to export any data you need before requesting deletion.
If you signed up with email and password, you can link your Google account under **Settings > Account > Connected Accounts**. Click **Connect Google** and complete the OAuth flow. Once linked, you can sign in with either method.
# Integrations
Source: https://docs.visibility.so/integrations
Connect Visibility.so with Google Analytics, Google Search Console, Google SSO, DataForSEO, and AI providers.
Visibility.so connects with third-party services to power SEO data, authentication, and AI visibility tracking. SEO integrations (Analytics, Search Console, DataForSEO) are configured per-project on **Project → Configuration → Integrations**.
***
## Google (Analytics + Search Console)
A single Google connection powers both **Google Analytics 4** (organic traffic, landing pages) and **Google Search Console** (queries, content opportunities). One consent screen grants both — you don't have to connect twice.
### Connecting
From your project, go to **Configuration → Integrations** and find the Google card.
Click **Connect**. You'll be redirected to Google and asked to grant read access to Analytics *and* Search Console at the same time.
Back on the Integrations page, pick the GA4 property that matches your project's domain.
Pick the verified Search Console site that matches your project's domain. The two pickers are independent — your GA property and your GSC site can have different display names but should describe the same website.
If you connected Google before Search Console support was added, the GSC card shows a one-click **Re-connect** that re-grants the new scope without breaking your existing Analytics access.
### What you get from Analytics
* **Traffic reports** — sessions, users, bounce rate, average session duration
* **Landing page performance** — top organic landing pages
* **Daily time-series** — for visualising trends
GA data appears on the project's **Overview** tab under **Organic Traffic**. The card refreshes on your configured cadence (default once a week, on Mondays); you can also tune the schedule from the Integrations card.
### What you get from Search Console
* **Content opportunities** (the Content Gap sub-tab on the project's **Opportunities** page) — real search queries scored and ranked by win likelihood. See the [SEO Features → Content Opportunities](/seo-features#content-opportunities) section for details.
The single Google account powers all three. Disconnecting from the Google card revokes Analytics + Search Console for *this project*. Other projects using the same Google account are unaffected.
***
## Google SSO
Sign in to Visibility.so with your Google account for a seamless authentication experience.
### How It Works
* **New users** — Click **Sign in with Google** on the login page. An account is automatically created and linked to your Google identity.
* **Existing users** — If you signed up with email/password, link your Google account under **Settings > Account > Connected Accounts**. Once linked, you can sign in with either method.
Google SSO uses OAuth 2.0. Visibility.so only requests basic profile information (name and email). No data from your Google account is accessed beyond authentication.
***
## DataForSEO
DataForSEO powers keyword ranking tracking, domain metrics, and SERP data within Visibility.so.
### Capabilities
| Feature | Description |
| -------------------- | ------------------------------------------------------------- |
| **Keyword rankings** | Track your position for target keywords across search engines |
| **Domain metrics** | Domain authority, referring domains, and backlink counts |
| **SERP data** | Search engine results page snapshots and competitor analysis |
### Platform-Managed vs BYOK
DataForSEO can operate in two modes:
API calls are routed through the Visibility.so platform using our default service configuration. No setup required — it works out of the box.
Enter your own DataForSEO API credentials under **Settings > Integrations > DataForSEO**. API calls go directly through your key instead of the platform's default managed service. Ideal for high-volume usage.
### Connecting BYOK
Sign up at [dataforseo.com](https://dataforseo.com) and locate your API login and password in their dashboard.
Go to **Settings > Integrations > DataForSEO** and enter your API login and password.
Click **Test** to verify the credentials work. Once confirmed, click **Save**.
All DataForSEO calls will now use your key.
***
## AI Providers
Visibility.so tracks how AI models mention, recommend, and rank your brand. The platform queries the following AI providers as part of **AI Visibility** tracking:
| Provider | What We Track |
| ---------------------- | ----------------------------------------------------------- |
| **ChatGPT** (OpenAI) | Brand mentions and recommendations in ChatGPT responses |
| **Claude** (Anthropic) | Brand mentions and recommendations in Claude responses |
| **Gemini** (Google) | Brand mentions and recommendations in Gemini responses |
| **Perplexity** | Brand citations and source references in Perplexity answers |
### How It Works
AI Visibility checks are automated. The platform periodically queries each AI provider with industry-relevant prompts related to your domain and keywords, then analyzes the responses for brand mentions, sentiment, and recommendation strength.
Results are displayed on the **AI Visibility** dashboard within each project, with breakdowns by provider and trend data over time.
AI Visibility scans are metered. Detailed consumption and billing will be introduced with our future pricing model.
# Introduction
Source: https://docs.visibility.so/introduction
Learn what visibility.so is and how AI-powered agents transform your SEO workflow.
Visibility.so is an AI-powered SEO platform that deploys autonomous agents to manage, monitor, and improve your search engine presence. Instead of manually running audits, tracking keywords, and building links, you assign the work to AI agents that operate continuously on your behalf.
Autonomous agents powered by Claude, Codex, Gemini, and OpenCode handle SEO tasks end-to-end -- from audits to content creation to outreach.
Organize your team with role-based access, reporting hierarchies, and project assignments. Agents and humans work side by side.
Track AI Visibility scores, keyword rankings, and organic traffic in one unified dashboard.
Manage content pipelines, link building campaigns, and SEO tasks with built-in project boards.
## Key Value Propositions
### Autonomous AI Agents
Every company on Visibility.so has a team of AI agents. Each agent has its own instructions, attached skills, and a reporting chain — hire from a preset like CEO, On-Page Auditor, Outreach Manager, or Content Writer, or build a fully custom agent from scratch. Agents can:
* Run SEO audits and surface actionable recommendations
* Draft and optimize content
* Manage link building outreach
* Execute tasks assigned by humans or other agents
### AI Visibility Tracking
Traditional SEO tools track Google rankings. Visibility.so also tracks how AI models -- ChatGPT, Claude, Gemini, and Perplexity -- mention and recommend your brand. This is the new frontier of search.
### Advanced SEO Data
We pull data from industry-leading sources to track your keyword rankings and domain metrics. Bring your own API keys (BYOK) for even greater control over your data sources and high-volume tracking needs.
### Built for Teams
Role-based permissions, org chart visualization, and project-level access control keep everyone aligned -- whether your team is 2 people or 200.
## Next Steps
Create your account and launch your first project in minutes.
Learn about our pricing status and upcoming plans.
# Projects
Source: https://docs.visibility.so/projects
Create and manage SEO projects with content, link building, and configuration modules.
Projects are the core organizing unit in Visibility.so. Each project represents a website or domain you are optimizing, with its own tasks, content pipeline, link building campaigns, and SEO configuration.
## Creating a Project
Navigate to the company where you want to create the project.
Enter a project name, optional description, and select the domain you want to optimize.
Add your target keywords, competitor domains, and topics. These drive your tracking and reporting.
Choose which modules to activate for this project: Content, Link Building, and Reports.
## Project Tabs
Each project has five main tabs:
### Overview
A dashboard showing project health at a glance: active tasks, keyword trends, AI Visibility scores, and recent agent activity.
### Tasks
The task board for this project. Create, assign, and track SEO tasks across statuses from backlog to done. See the [Tasks](/tasks) page for details.
### Content
Manage your content pipeline:
* Plan content around target keywords and topics
* Track content from draft through review to published
* Assign content tasks to AI agents or human writers
### Link Building
Manage outreach and backlink acquisition:
* Identify link prospects
* Track outreach status and responses
* Monitor acquired backlinks
### Configuration
Project-level settings including:
* **Domain**: The primary domain being optimized
* **Keywords**: Target keywords for ranking and tracking
* **Competitors**: Competitor domains for benchmarking
* **Topics**: Topic clusters for AI Visibility tracking
* **DataForSEO / BYOK**: Connect your own API keys for direct data access
* **Google Analytics**: Link a GA4 property for traffic data
## Enabling and Disabling Modules
Not every project needs every module. Toggle modules on or off from the Configuration tab:
| Module | What It Does |
| ------------- | ---------------------------------------------- |
| Content | Enables the content pipeline and content tasks |
| Link Building | Enables outreach tracking and link tasks |
| Reports | Enables automated report generation |
Disabling a module hides it from the project interface but does not delete any data. Re-enable it at any time to restore access.
## Activity Tracking
Each project tracks SEO activity across all modules, including:
* AI Visibility check history
* Keyword ranking pull frequency
* Agent task execution and output
Activity data is available on the project Overview tab to help you monitor project progress and data freshness.
# SEO Features
Source: https://docs.visibility.so/seo-features
Explore AI Visibility tracking, keyword rankings, organic traffic analytics, and automated scheduling.
Visibility.so provides a comprehensive suite of SEO intelligence tools that go beyond traditional search engine tracking.
## AI Visibility
Track how AI models mention, recommend, and describe your brand. This is one of the defining features of Visibility.so.
### How It Works
AI Visibility checks query major AI models with your configured topics and measure how prominently your brand appears in the responses.
### Supported AI Models
| Provider | Description |
| ---------- | -------------------------- |
| ChatGPT | OpenAI's conversational AI |
| Claude | Anthropic's AI assistant |
| Gemini | Google's AI model |
| Perplexity | AI-powered search engine |
### Configuration
Set up AI Visibility tracking in your project's Configuration tab:
* **Topics**: The subjects and queries where you want to be mentioned
* **Brands**: Your brand names and variations to detect
* **Domains**: Your website domains to identify in citations
* **Competitors**: Competitor brands and domains to benchmark against
### Automated Checks
Schedule AI Visibility checks to run automatically. Each check queries the configured AI providers with your topics and produces a visibility report.
AI Visibility checks are metered based on the number of providers queried. Detailed billing will be introduced with our future pricing model.
### Visibility Scores
Results are expressed as a **score from 0 to 100%**, reflecting how visible your brand is in AI responses for a given topic:
* **0%**: Not mentioned at all
* **1-25%**: Minimal presence
* **26-50%**: Moderate presence
* **51-75%**: Strong presence
* **76-100%**: Dominant presence
Scores are tracked over time so you can see trends and measure the impact of your SEO efforts on AI-generated answers.
***
## Keyword Rankings
Track your search engine keyword positions using the DataForSEO integration.
### Features
* **Position tracking**: Monitor where your pages rank for target keywords
* **Historical trends**: See how rankings change over time with visual charts
* **Competitor comparison**: Compare your keyword positions against competitor domains
* **Location and language support**: Track rankings for specific geographic regions and languages
### Setup
Keywords are configured at the project level. Add your target keywords in the project Configuration tab. Ranking data is pulled automatically based on your schedule.
Keyword ranking pulls are performed via our managed service or your own BYOK keys. Use BYOK to manage your API usage directly with DataForSEO.
***
## Organic Traffic
Connect Google Analytics 4 to pull organic traffic data directly into Visibility.so.
### Landing Page Reports
See which pages drive the most organic traffic, with metrics including:
* Sessions and users
* Bounce rate
* Average session duration
* Conversions (if configured in GA4)
### Traffic Sources
Break down traffic by source to understand which channels are driving visitors:
* Organic search
* Direct
* Referral
* Social
### Session Metrics
Track key session metrics over time to measure the overall health of your organic presence.
### Setup
Open the Configuration tab in your project.
Click the Google Analytics integration and authenticate with your Google account.
Choose the GA4 property that corresponds to your project domain.
Organic traffic data will appear in your project dashboard within a few hours.
***
## Content Opportunities
The **Content Gap** sub-tab on a project's Opportunities page surfaces real search queries — pulled from your Google Search Console — and ranks them by how likely a focused content piece is to win the click.
Use it to find topics where Google already shows you to users but no page is converting that demand into traffic.
### Where the data comes from
Once you connect Google Search Console (one-time, from **Project → Configuration → Integrations**) and pick a verified site, you can pull your last 28 days of search queries with the **Fetch now** button at the top of the Content Gap tab. Each refresh reads the queries dimension plus, for the most promising ones, the page that's currently surfacing.
You don't need to add keywords by hand — the data is whatever Google is already showing you.
### How queries get scored
Every query that survives the filters gets a **Win Score** from 0 to 100. The score combines four signals:
| Signal | What it captures |
| ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Demand** | Whether the query gets enough impressions to be worth chasing |
| **Position** | How close you are to the front page — striking-distance positions score highest, top-3 positions score low (already winning), and very far back positions score low (not realistic) |
| **CTR gap** | Whether the click-through rate is *worse* than typical for that position — a big gap means the current SERP presence is weak and a focused page can take its share |
| **Intent** | Whether the query has a clear content format (how-to, comparison, listicle, definition, troubleshooting, etc.) |
Final scores are bucketed into four tiers shown next to each row:
| Tier | Meaning |
| ---------------- | ------------------------------------------------------ |
| 🔥 **Quick Win** | High score across all four signals — write this week |
| ⭐ **Strong** | A clear opportunity with one weak signal — next sprint |
| 💡 **Consider** | Worth thinking about — backlog |
| **Low priority** | Hidden by default; toggle to see |
The list is sorted by Win Score by default. You can sort by impressions, position, or CTR instead, and filter by tier, intent, or action type.
The exact formula weights, intent classifier, and brand-exclusion logic are continually tuned and aren't documented in detail — the inputs (impressions, position, CTR, intent tag) are stored alongside the score so you can always see *why* a row is rated the way it is.
### "New content" vs "Optimize existing"
For the highest-scoring queries, Visibility does a second pass to find the page on your site currently ranking for that query. If a page from your domain is already surfacing, the row gets tagged **Optimize existing** — adding a fresh post would compete with yourself; it's better to improve the existing page. Otherwise it's tagged **New content**.
You can filter by either tag.
### Brand exclusion
Branded queries (people searching for your company name) are filtered out automatically — they're already converting, so they aren't content opportunities. Visibility derives the brand list from your connected site URL on first connect; you can edit it later.
### Why some queries are missing
Three filters are applied before scoring:
1. **Volume floor** — queries with too few impressions are skipped
2. **Brand match** — branded queries are excluded
3. **Intent classifier** — queries that don't look like a content opportunity (vague single-words, navigational lookups) are dropped
You'll see a small summary on each manual sync showing how many were filtered out at each step.
### Acting on an opportunity
Each row in the list has a **⋯ menu** with two actions:
* **Convert to content task** — creates a task in your Content module, pre-filled with the query, the suggested format, the why-line, and the current performance stats. The task lands in **Project → Content → Tasks** ready to be picked up.
* **Dismiss** — hides the row across future syncs so it stops cluttering the list. You can show dismissed rows again from the toggle at the top.
Converting to a content task requires the Content module to be enabled on the project (**Configuration → Features → Content**). If it's off, the action returns an error pointing you at the toggle.
### Refresh cadence
For now, syncs are triggered manually via the **Fetch now** button at the top of the Content Gap tab. Recurring schedules (similar to the keyword and organic-traffic schedules) are on the way — see the changelog for updates.
GSC data has a 2–3 day reporting lag from Google's side; the most recent days won't appear until they finalise.
***
## Schedules
Automate SEO checks with cron-based scheduling.
### What Can Be Scheduled
* AI Visibility checks
* Keyword ranking pulls
* Automated reports
### How Scheduling Works
Set a cron schedule for each check type. Schedules support standard cron expressions, or you can use preset intervals:
| Preset | Frequency |
| --------- | --------------- |
| Daily | Once per day |
| Weekly | Once per week |
| Bi-weekly | Every two weeks |
| Monthly | Once per month |
Start with weekly checks and adjust based on how actively you're optimizing. More frequent checks provide higher resolution data for tracking trends.
### Viewing Results
Scheduled check results appear in your project dashboard and are available in the SEO reports section. Historical data is retained so you can track trends over any time period.
# Tasks
Source: https://docs.visibility.so/tasks
Create, assign, and manage SEO tasks for humans and AI agents.
Tasks are the core unit of work in Visibility.so. They track everything from content briefs to technical audits to link outreach, and can be assigned to both humans and AI agents.
## Task Types
| Type | Purpose |
| ------------- | ------------------------------------------------- |
| General | Any SEO task that doesn't fit a specific category |
| Content | Content creation, optimization, and publishing |
| Link Building | Outreach, prospect management, and backlink tasks |
## Task Statuses
Tasks follow a kanban-style workflow:
```shellscript theme={null}
backlog --> todo --> in_progress --> in_review --> done
```
| Status | Meaning |
| ------------- | ------------------------------------- |
| `backlog` | Identified but not yet planned |
| `todo` | Planned and ready to be started |
| `in_progress` | Actively being worked on |
| `in_review` | Complete, awaiting review or approval |
| `done` | Finished and closed |
## Priority Levels
| Priority | When to Use |
| -------- | ------------------------------------------------------- |
| Critical | Urgent issues that block other work or impact live site |
| High | Important tasks that should be addressed soon |
| Medium | Standard priority for regular work |
| Low | Nice-to-have tasks with no time pressure |
## Assigning Tasks
Tasks can be assigned to:
* **Human team members**: any member with access to the project
* **AI agents**: any active agent in your company
When you assign a task to an AI agent, the agent automatically begins working on it based on its instructions and attached skills.
### Creating a Task
Navigate to your project and open the **Tasks** tab.
Select the task type (General, Content, or Link Building).
Add a title, description, priority, and optional due date.
Choose a human team member or AI agent to own the task.
The task is created in the **backlog** status by default. Move it to **todo** when it's ready to be started.
## Task Approvals
Some tasks require approval before they can be marked as done:
* When an AI agent completes a task, it may move to `in_review` for human approval.
* The reporting manager or a project admin can approve or request changes.
* Approval requirements can be configured in your [company settings](/company-settings).
Agent approval requirements are a company-level setting. When enabled, all agent-completed tasks require human review before closing.
## Filtering and Bulk Operations
### Filtering
Filter the task board by:
* Status
* Priority
* Assignee (human or agent)
* Task type
* Due date range
### Bulk Operations
Select multiple tasks to perform bulk actions:
* Change status
* Reassign
* Update priority
* Move to a different project
# Team Management
Source: https://docs.visibility.so/team-management
Manage roles, permissions, invitations, and reporting hierarchy for your team.
Visibility.so supports multi-user teams with role-based access control, reporting hierarchies, and project-level permissions.
## Roles
Every team member is assigned a role that determines their access level:
| Role | Access Level |
| -------- | ------------------------------------------------------------- |
| Admin | Full access to all settings, billing, agents, and projects |
| Manager | Access to most features; can manage team members and projects |
| Employee | Limited access; can work on assigned projects and tasks only |
The account owner is always an Admin and cannot be downgraded.
## Inviting Members
Open your company dashboard and navigate to the **Team** section.
Enter the team member's email address and select their role (Admin, Manager, or Employee).
The invitee receives an email with a link to join your company. The invitation expires after **7 days**.
Once the invitee accepts, they appear in your team roster and can be assigned to projects.
You can resend or revoke pending invitations from the Team settings page.
## Reporting Hierarchy
Every team member (human or agent) can have a reporting manager:
* **Humans** can report to other humans.
* **Agents** can report to humans or other agents.
* The hierarchy is used for task delegation, approval workflows, and organizational structure.
### Setting Up Reporting
When adding or editing a team member or agent, select their reporting manager from the dropdown. This creates a direct reporting relationship visible in the org chart.
## Project Assignments
Control which projects each team member can access:
* **Admins** have access to all projects by default.
* **Managers** and **Employees** can be restricted to specific projects.
* Assign project access from the team member's profile or from the project's team settings.
Team members without project access cannot see or interact with that project's tasks, content, or data.
## Org Chart
The Org Chart provides a visual representation of your team's reporting structure:
* See who reports to whom at a glance
* Both human members and AI agents appear in the chart
* Drag and drop to reorganize reporting lines (Admin only)
Access the Org Chart from the **Team** section in your company dashboard.
## Permission Keys
Permissions are enforced through a set of **permission keys** that map to specific actions:
| Category | Examples |
| -------- | ---------------------------------------------------- |
| Company | Edit settings, manage billing, archive company |
| Team | Invite members, change roles, remove members |
| Projects | Create projects, edit configuration, delete projects |
| Tasks | Create tasks, assign tasks, approve tasks |
| Agents | Create agents, pause agents, view transcripts |
| SEO | Run checks, view reports, manage schedules |
Each role (Admin, Manager, Employee) has a predefined set of permission keys. The exact permissions for each role are visible in your company settings under **Roles & Permissions**.