Visibility Agent
Vaera's Visibility Agent prepares your store to be found and recommended by search engines and AI discovery tools - Google, ChatGPT, Perplexity, Gemini, and more. It audits your store's discoverability, generates AI context files, and tells you exactly what to fix first.
Plan and access
What the Visibility Agent Does
Most merchants have two discoverability problems they cannot easily see. First, AI answer engines like ChatGPT and Perplexity do not know enough about their store to recommend it confidently. Second, product pages are not structured in a way that lets AI shopping engines understand what is being sold, who it is for, and why it should be recommended.
The Visibility Agent addresses both. It continuously evaluates your store across five dimensions, surfaces specific gaps, generates the technical files AI crawlers need, and audits every product against the signals that drive AI recommendations.
AI Visibility Score
A five-category score (out of 80) measuring how ready your store is for AI discovery. Each category shows your current points, your maximum, and the specific thing to improve.
llm.txt Generator
A plain-text AI context file served at your store URL that summarises your brand, products, categories, policies, and FAQs for AI crawlers that need a structured overview of your business.
AI Shopping Feed
A machine-readable JSON product catalog served at ai-products.json. AI shopping engines and agentic commerce tools can read your entire catalog in a single request.
Product Readiness Audit
A per-product table that scores every active product against the signals AI recommendation engines need. Prioritised by impact, with direct links to improve each product.
Opportunity Indicators
Separate signal cards for AI Bot Activity and Content Authority - showing how often AI crawlers visit your store and how much content authority you have built up.
The AI Visibility Score
The headline number is your AI Visibility Score, shown out of 80. It is computed on the backend from five categories that cover the dimensions of discoverability you can directly control. The score updates automatically when you make changes to your store, and you can manually trigger a recalculation at any time.
Why 80, not 100?
The Five Categories
| Category | What It Measures |
|---|---|
| Technical Crawlability | Sitemap, robots.txt, canonical URLs, custom domain |
| Structured Data Coverage | Schema coverage across homepage, product pages, categories, and blog posts |
| Product Data Quality | Title clarity, description depth, images, ALT text, price visibility, stock status, categories, reviews |
| AI Context Readiness | Store description, About page, FAQ page, policies, and llm.txt status |
| Trust Signals | Reviews, social links, and contact information |
Technical Crawlability
This category reflects how accessible your store is to AI discovery bots. A store that cannot be found and crawled will not appear in AI recommendations. Your Growth plan activates the technical foundation bots need, and having a live storefront with published content maximises your score here.
Structured Data Coverage
Vaendora automatically generates and publishes structured data markup on your storefront pages, helping AI engines understand what type of content they are reading. This category reflects how much of your content is covered by that markup. Publishing more products, categories, and pages naturally expands your coverage over time.
Schema is automatic
Product Data Quality
This is the highest-weighted category because the richness of your product listings is the primary factor AI recommendation engines use when deciding whether to cite a store. Your catalog is evaluated holistically - the more complete and informative your products are, the higher this category scores. Use the AI optimization tools on your product pages to improve multiple products quickly.
Use AI optimization to improve this quickly
AI Context Readiness
AI assistants need to understand your brand, not just your individual products. This category reflects how well your store communicates who you are and what you sell beyond individual product pages. Publishing brand and policy content - and generating your llm.txt - contributes to the overall picture AI engines build of your business.
Trust Signals
AI engines are more likely to recommend stores they can verify as active, legitimate businesses. This category reflects the visible social proof and contact accessibility of your store. Encouraging customer reviews and keeping your contact and social details up to date are the most direct ways to improve it.
Opportunity Indicators
Below the score breakdown, two signal cards appear that are not included in your core score. They show additional opportunities to strengthen your discoverability over time.
AI Bot Activity
Shows how many AI crawlers have visited your store in the last 30 days, which bots are active (GPTBot, PerplexityBot, ClaudeBot, etc.), and how many of your product pages have been crawled. A "View full report" link takes you to the AI Bot Traffic page for the complete breakdown. Status labels are "Active crawling", "Low activity", or "No recent visits."
Content Authority
Shows how many blog posts you have published and whether you are using SearchSignal to generate topic-led content. More published content that answers real customer questions improves how authoritative your store appears to AI search engines. Status labels are "Strong", "Growing", or "Not started."
Top Action Items
Below the opportunity indicators, the Visibility Agent surfaces three to five prioritised action items - specific things to fix, ranked by the impact they will have on your score. Each item includes a direct link to the relevant part of the dashboard so you can act immediately.
Examples of high-priority action items:
- "18 products have descriptions under 30 words. Start with your top sellers." - links to Products
- "Generate your llm.txt to help AI assistants understand your brand." - links to Generate
- "Add an About page to strengthen brand context for AI search." - links to Create page
Recalculate your score
llm.txt - AI Context File
llm.txt is a plain-text file served at your store URL that summarises your business in a format that AI crawlers and large language models can read directly. It is a companion to structured data - not a replacement. Where JSON-LD tells an AI what your products cost and how they are categorised, llm.txt tells it who you are, what you stand for, and how you want to be described.
What Goes into Your llm.txt
The Visibility Agent generates the file automatically from your existing store data. It includes:
- Your store name, tagline, and full description
- About page content
- All category names and descriptions
- Your active products with name, price, short description, and URL
- Shipping and returns policy summaries
- FAQ page content
- Contact email and phone
- Social media links
- Key page URLs (storefront, products, blog, sitemap)
Where It Is Served
Once generated, your llm.txt is available at:
- Custom domain:
https://yourdomain.com/llm.txt - Vaendora URL:
https://app.vaendora.com/shop/[yourslug]/llm.txt
The dashboard shows your URL with a Copy URL button and a Preview button so you can see the content before sharing it.
Generating Your llm.txt
Open the Visibility Agent dashboard
Go to Commerce → Storefront → AI Visibility Optimization in your merchant dashboard.
Find the AI Discovery Files section
Scroll past the score breakdown and opportunity indicators to the "AI Discovery Files" section. You will see the llm.txt card.
Click Generate (or Regenerate)
Click the Generate button on the llm.txt card. After the first generation, the button changes to Regenerate. The status indicator shows "Active" and the last generated time.
Copy your URL
Use the Copy URL button to share your llm.txt address. You can also click Preview to read the generated content and verify it accurately describes your business.
Score impact
AI Shopping Feed
The AI Shopping Feed is a machine-readable JSON product catalog served at a public URL. AI shopping engines, comparison tools, and agentic commerce layers can read your entire active product catalog in a single request, rather than crawling individual product pages one by one.
Where It Is Served
- Custom domain:
https://yourdomain.com/ai-products.json - Vaendora URL:
https://app.vaendora.com/shop/[yourslug]/ai-products.json
What the Feed Contains
The feed includes all active products set to appear on your storefront. For each product it includes:
- Product name and direct URL
- Product description
- Category name
- Price and sale price in Naira
- Availability status
- All product images with ALT texts
- Whether the product has reviews
The feed also includes store-level information: name, description, logo, currency, and all categories. It updates automatically as your product catalog changes.
The AI Shopping Feed card on the dashboard shows the feed URL, a live product count, and a Copy URL button.
AI Shopping Title
Product Recommendation Readiness Audit
The Product Readiness section is a table that scores every active, storefront-visible product against the signals that AI recommendation engines check when deciding whether to surface a product. It tells you which products are well-optimised and which need work - sorted by impact.
Above the table, a summary bar shows how your catalog is performing overall: the average readiness across all your products, how many products still need attention, and how many have reached a strong readiness level. This gives you a quick sense of where your catalog stands before you work through the rows.
What the Audit Checks
Each product is evaluated on how well its listing is prepared for AI discovery - covering the content, media, and metadata that recommendation engines rely on. Improving any gap raises that product's readiness score.
How Priority Is Calculated
Each product receives a readiness score and is assigned a priority based on that score combined with how recently it was added to your catalog:
High Priority
Readiness is low and the product was recently added. These are the products most likely to be missing from AI recommendations right now.
Medium Priority
Readiness is partial - the product passes some checks but still has gaps worth addressing.
Low Priority
Readiness is strong. This product is well-optimised for AI recommendation. You can still improve it, but other products should come first.
Acting on the Audit
Each row in the product readiness table shows the product name, its readiness score, the specific signals it is missing, its priority, and action options.
- Improve - opens the product edit page directly so you can fix the missing signals without searching through your catalog
- View - for well-optimised products, links to the product page for a quick review
- Optimise title - generates AI-suggested alternative titles for the product directly from the table row, without opening the product. Choose a suggestion and apply it in one step.
You can filter the table to show only products that "Need work" and sort by priority to work through your highest-impact improvements first.
AI Readiness Panel
When you open a product to edit it, an AI Readiness Panel appears alongside the product form. It gives you a live snapshot of how AI-ready that specific product currently is, so you can spot gaps while you are still on the page rather than discovering them later in the readiness table.
Where It Appears
- Desktop - a sticky panel in the right sidebar, always visible as you scroll through the form
- Mobile - a collapsible card near the top of the form that you can expand to check at any point
Live Updates
The panel refreshes automatically a moment after you stop typing or make a selection on the form - updating the readiness assessment as you work. You can also click the Refresh button in the panel header to force an immediate recalculation.
The panel shows which areas of the product are contributing to its readiness and which are not yet in place. It is a read-only view - it does not save changes. Saving the product is still a separate step, and saved changes are what update your overall AI Visibility Score.
Use it while you edit
Optimise Title
Vaendora's AI can suggest alternative product titles that are clearer and more descriptive for both customers and AI shopping engines. The tool is available in two places: the product edit page and the product list.
Where to Find It
- Product edit page - look for the Optimise Title button near the product name field
- Product list - click the sparkles icon on any product row, then select Optimise title
How It Works
Clicking the button generates a set of AI-suggested alternative titles. Each suggestion is shown with two options:
- Copy - copies the suggestion to your clipboard
- Apply - replaces the product's current title with the suggestion. From the product list, the row updates live without opening the product.
The tool has a daily usage limit that resets overnight. The limit is shared between the edit page and the product list - using either entry point counts towards the same daily total. When the limit is reached, the button will indicate this and the counter resets the following day.
When to use it
Audit Description
The Audit Description tool analyses your product description and returns a quality score with specific recommendations. It assesses how well your description helps potential buyers understand the product and make a purchase decision - the same qualities AI recommendation engines look for when deciding whether a product is worth surfacing.
Where to Find It
- Product edit page - a dedicated Audit Description panel below the description field
- Product list - click the sparkles icon on any product row, then select Audit description. Results slide in as a panel on the right side of the screen.
What You See
The audit returns a quality score and a breakdown of what your description is doing well and what it is missing. For each area that needs improvement, you get a specific recommendation so you know exactly what to add or change rather than guessing.
The last audit result is automatically loaded when you open the product edit page, so you can review your previous score without running a new audit. This is useful for checking where you left off before making further changes.
Score History
Each time you run a new audit, the result is saved. When you have run multiple audits on the same product, a score history trail appears showing how the quality has changed over time - from the earliest audit to the most recent. Hover over any entry in the trail to see the exact date and time it was assessed.
Usage and Limitations
- The tool has a daily usage limit shared across both the edit page and the product list. It resets overnight.
- If a product has no description text, the audit option will be disabled automatically - there is nothing to assess. Add a description first, then run the audit.
How to Improve Your Score
The following actions have the highest impact and are the ones the Visibility Agent is most likely to surface in your Top Action Items.
Write detailed product descriptions
Product Data Quality is the highest-weighted category in your score. Thin descriptions are the most common reason stores score poorly. Aim for thorough product descriptions that cover materials, use cases, and benefits. Use the AI description optimization tool to generate these in one click.
Add ALT text to product images
Image ALT text is required for AI vision engines to understand your products from their photos. Run Search Listing Optimization on your products - the AI vision model will analyze each photo and generate accurate, descriptive ALT text automatically.
Generate your llm.txt
This is one of the fastest ways to improve your AI Context Readiness score. Find the AI Discovery Files section and click Generate. It takes seconds and uses your existing store data.
Publish an About page and FAQ page
Both pages improve your AI Context Readiness score. A FAQ page also enables structured markup that helps AI engines extract specific answers about your business. Go to Storefront → Pages to create them.
Connect a custom domain
A custom domain improves your Technical Crawlability score and significantly increases your authority with AI engines. Go to Domains to connect or purchase one.
Encourage product reviews
Reviews improve both your Trust Signals and Product Data Quality scores. Products with reviews are more likely to be recommended by AI. Send a follow-up message to recent customers and ask them to leave a review.
Add social links to your storefront
Social links improve your Trust Signals score and help AI engines verify your business identity. Add them under Commerce → Storefront → Store Setup.
AI Bot Traffic
For AI engines to recommend your store, their crawlers first need to visit it. Vaendora configures your storefront's robots.txt to explicitly allow all major AI crawlers, and generates a comprehensive XML sitemap so they can discover every product, category, and page.
The AI Bot Activity card in the Visibility Agent dashboard shows a summary of crawler activity in the last 30 days. For the full breakdown (which bots, which page types, crawl frequency over time), go to the dedicated AI Bot Traffic report linked from the card.
New stores
Best Practices
Fix the highest-impact category first
Product Data Quality is the highest-weighted category in your score. If your products have thin descriptions or no ALT text, fixing those moves the needle more than any other single action. Check the Top Action Items card for your specific highest-leverage opportunities.
Use the product readiness table as your to-do list
Filter to "Needs work" and work through High priority products first. The Improve button takes you directly to that product's edit page, so there is no searching. Fixing ten high-priority products in one session has more impact than doing one product a day.
Regenerate llm.txt after major catalog updates
Your llm.txt is generated from your store data at the time you click Generate. If you add new products, update your About page, or change your store description, regenerate your llm.txt so AI crawlers read the updated version.
Treat visibility as ongoing, not a one-time task
AI discoverability improves gradually as you publish more content, earn more reviews, and maintain accurate product data. Check your score monthly, address the top action items, and track whether AI bot visits are increasing. Each improvement compounds.
Link to products from your blog
AI crawlers follow internal links. Blog posts that link to product pages increase the likelihood that those products get crawled and indexed. The Content Authority opportunity indicator tracks your blog post count for this reason.
Keep your data current and accurate
AI engines penalise stores with stale or inaccurate information. Mark out-of-stock items correctly, keep prices up to date, and ensure your contact details are current. Accuracy builds trust with AI recommendation systems over time.
Frequently Asked Questions
What is the difference between the Visibility Agent and the AI Visibility Optimization page?
They refer to the same feature. "Visibility Agent" is the name for this AI capability across the Vaendora platform. The merchant dashboard calls the page "AI Visibility Optimization." The AI Visibility Optimization documentation covers the underlying technical details - structured data schemas, robots.txt, sitemap, testing tools, and the original v1 score for historical reference.
Does a high score guarantee my products will be recommended by ChatGPT or Perplexity?
No. A strong score gives your business a significantly better chance of being discovered, cited, and recommended - but AI engines make their own ranking decisions based on many factors outside your control, including query relevance and the strength of competing stores in your category. The Visibility Agent optimises the signals you can control.
How often does the score refresh automatically?
The score is cached and recalculated automatically when you save product changes, add or edit storefront pages, or regenerate your llm.txt. You can also trigger a manual recalculation from the score card, limited to once every 15 minutes.
Is llm.txt a recognised standard?
The llm.txt convention is an emerging practice adopted by a growing number of AI developers and LLM teams to help their models read structured context about a website or business. It is not a formal web standard yet, but it is gaining adoption across AI companies. Generating one costs nothing and has no downside.
Can I access the AI Shopping Feed without a custom domain?
Yes. Your feed is available at the Vaendora URL even without a custom domain. However, having a custom domain is recommended for full AI discoverability since it adds points to your Technical Crawlability score and increases your authority with AI engines.
Will Optimise Title change my product name automatically?
No. Optimise Title generates a suggested title based on your product, but nothing changes until you choose to apply it. You review the suggestion first and decide whether to use it, edit it, or dismiss it. Your original title is never overwritten without your approval.
Does running an Audit Description change my product description?
No. An audit only analyses your existing description and surfaces specific feedback on what is working well and what could be stronger. Your description stays exactly as it is. Any changes you decide to make are entirely up to you.
Do I need to save the product for the AI Readiness Panel to update?
No. The panel refreshes automatically a moment after you stop typing or make a change on the form, so you see updated readiness feedback without saving. Saving the product is a separate step - it is what updates your overall AI Visibility Score, not the panel itself.
Do I need an AI Shopping Title on every product?
No. If a product does not have an AI Shopping Title, Vaendora falls back to your standard product title when serving your AI Shopping Feed. Adding an AI Shopping Title is optional but recommended for products where a more descriptive, search-optimised label would help AI engines understand and surface that item more accurately.