Skip to main content
This guide explains the main terms and ideas you’ll see across Serpy. You do not need to memorize everything. Use this page as a reference when you want to understand what something means or how different parts of Serpy connect.

Website / workspace

A website is the main site you are managing inside Serpy. Each website has its own content, search data, prompt groups, recommendations, strategy keywords, integrations, and settings. If you manage more than one brand or domain, each one should be added as a separate website.

Brand context

Brand context is the information Serpy uses to understand your business. It can include:
  • what your business does
  • who you help
  • your services or products
  • your locations
  • your tone and positioning
  • your competitors
  • your important pages
Brand context helps Serpy create better prompts, recommendations, outlines, and articles. You can update it in Settings.

Google Search Console

Google Search Console connects your real search performance data to Serpy. It helps Serpy understand:
  • which pages get clicks
  • which keywords bring impressions
  • which pages are growing or declining
  • where you may have SEO opportunities
  • how your content performs after publishing
Some performance sections need Google Search Console to show useful data.

CMS

Your CMS is the platform where your website content is published. Examples include WordPress, Shopify, Webflow, Wix, Framer, Sanity, Supabase, or a custom API. When your CMS is connected, you can publish or schedule content from Serpy. If your CMS is not connected, you can still create content and export it manually.

Prompt groups

Prompt groups help you track how AI platforms answer questions related to your brand, industry, products, services, and competitors. A prompt group contains multiple prompts around one topic. For example, a prompt group about SEO services may include:
  • What are the best SEO agencies in Toronto?
  • How do I choose an SEO consultant?
  • What should I look for in an SEO agency?
  • Which SEO companies work with small businesses?
Prompt groups are one of the main ways Serpy tracks AI visibility.

Prompts

Prompts are the questions or searches that Serpy tracks across AI platforms. They should sound like real questions your customers may ask before making a decision. Good prompts are usually specific and conversational. Example:
  • Good: What are the best project management tools for remote creative teams?
  • Too broad: Project management tools
The better your prompts are, the more useful your AI visibility results will be.

AI visibility

AI visibility shows how often and how well your brand appears in AI-generated answers. Serpy helps you understand:
  • whether your brand is mentioned
  • where your brand appears
  • which competitors appear
  • which websites are cited
  • which prompts you are visible for
  • where you may need better content or stronger source mentions
AI visibility is different from traditional search ranking. It focuses on how AI platforms describe, recommend, and cite brands.

Brand mentions

A brand mention happens when an AI answer includes your brand name. Mentions help you understand whether AI platforms are aware of your brand and include it in relevant answers. A mention does not always mean your website was cited. It simply means the brand appeared in the response.

Citations

A citation is when an AI answer references or links to a website as a source. Citations are important because they show which websites AI platforms are using to support their answers. If your website is cited, that can be a strong signal that your content is useful for that topic.

Sources

Sources are the websites AI platforms cite or appear to rely on when generating answers. Sources can include:
  • your website
  • competitor websites
  • directories
  • review sites
  • publications
  • partner pages
  • industry websites
Serpy helps you understand which sources matter in your category and where your brand may need to be listed.

Competitors

Competitors are brands that appear alongside yours in AI answers, search results, or content opportunities. Serpy uses competitor visibility to help you understand who is being recommended, compared, or cited in your space. This can help you find content gaps, source opportunities, and positioning opportunities.

Recommendations

Recommendations are actions Serpy suggests based on your AI visibility and content opportunities. They may include:
  • content you should create
  • sources where your brand may need to be listed
  • topics your competitors are visible for
  • opportunities to improve your brand’s presence
Recommendations help turn visibility data into practical next steps.

Strategy keywords

Strategy keywords are the keywords you want your website to focus on. They help Serpy understand the topics you care about and can be used in strategy planning, topical clusters, and content opportunities. Use strategy keywords for important services, products, categories, locations, and buying-intent topics.

Topical clusters

Topical clusters group related keywords around a larger topic. They help you plan content in a more organized way instead of creating one-off articles. A topical cluster usually includes:
  • a main topic
  • a primary keyword
  • related keywords
  • possible article ideas
Clusters help you build authority around a topic over time.

Content opportunities

Content opportunities are topics, keywords, or pages where Serpy sees a chance to create or improve content. They may come from:
  • keyword research
  • topical clusters
  • competitor scans
  • page targeting
  • auto scans
  • prompt group results
  • recommendations
A content opportunity is a signal that there may be value in creating, updating, or optimizing content.

Content Hub

Content Hub is where your articles and pages are created, organized, edited, and managed. You can use Content Hub to:
  • create new content
  • continue editing drafts
  • review outlines
  • optimize articles
  • schedule content
  • publish or export content
  • organize content into folders
Content Hub is where most content work happens in Serpy.

Outline

An outline is the plan for an article before the article is written. It usually includes:
  • title
  • recommended structure
  • headings
  • questions to answer
  • suggested internal links
  • research notes
  • metadata suggestions
Reviewing the outline before generating the article helps make sure the content is going in the right direction.

Content Editor

The Content Editor is where you edit and optimize an article. It includes the writing area and the optimization panel. Use it to review:
  • content score
  • metadata
  • keywords
  • headings
  • questions
  • internal links
  • article edits
  • publishing options
The Content Editor helps you improve content before it goes live.

Content score

Content score is Serpy’s way of showing how well an article is structured and optimized. It can reflect things like:
  • keyword usage
  • headings
  • questions answered
  • metadata
  • content structure
  • internal linking
  • overall completeness
Use the score as a guide, not a replacement for judgment. A higher score usually means the article is more complete and better aligned with the topic.

Serpy Optimize

Serpy Optimize reviews your article and suggests improvements. You can review each suggested edit before applying it. Use it when you want help improving clarity, structure, optimization, or completeness before publishing. Internal links are links from one page on your website to another page on your website. They help users and search engines understand how your content is connected. Serpy can suggest internal links based on your existing pages and the article you are working on.

Custom Voice

Custom Voice lets Serpy write closer to your own style. You can add a writing sample, and Serpy will use that style when creating content. Use Custom Voice if you want articles to sound more like your brand, founder, team, or existing content.

Custom instructions

Custom instructions let you give extra guidance for a specific article. You can use them to tell Serpy things like:
  • what angle to take
  • what to avoid
  • what products or services to mention
  • what audience to write for
  • what examples to include
Use custom instructions when the article needs extra direction beyond the keyword or prompt.

Usage limits

Usage limits are based on your plan. They may apply to things like:
  • websites
  • prompt groups
  • prompts
  • articles
  • keyword searches
  • scans
  • tracked pages
  • images
  • optimization features
Some limits are account-wide, while others may apply to a specific website. You can review your usage in Settings.

How everything connects

Serpy works best when each section feeds into the next. A common workflow looks like this:
  1. Add your website.
  2. Connect Google Search Console.
  3. Create prompt groups.
  4. Review AI visibility results.
  5. Find recommendations and content opportunities.
  6. Generate an outline.
  7. Create and optimize the article.
  8. Publish or export it.
  9. Track performance over time.
You can use each feature separately, but the real value comes from connecting visibility, strategy, content, and performance together.