🚀 Quick Start Guide
⚡ Get Started in 5 Minutes
Follow these simple steps to add your first entity schema and start improving your AI search visibility today!
Installation
1
Navigate to Plugins
Go to WordPress Admin → Plugins → Add New
2
Search for Plugin
Search for "Sekhlo Schema Code"
3
Install & Activate
Click "Install Now" then "Activate"
✓
Done!
No configuration required. Start using immediately!
Setting Up Entity (Most Important Step)
🏛️ Set Your Entity First
The Entity Builder is the most important feature in v2.0. Set it once and it injects sitewide. This is what AI search engines use to identify and cite your brand.
1
Edit Any Post or Page
Go to any post or page in the WordPress editor
2
Open Entity Tab
Scroll down to the "Sekhlo Schema Manager" meta box and click the "Entity" tab
3
Select Entity Type
Choose Person, Organization, Local Business, News/Blog, E-Commerce Store, or Educational Organization
4
Fill In Your Profiles
Add your name, LinkedIn, Twitter, Wikipedia, Google Business, and other profile URLs
5
Generate & Inject
Click "Generate sameAs Schema" then "Save & Inject to <head> (All Pages)"
🎉
Entity Active Sitewide!
Your entity schema now injects on every page of your site automatically
Adding Your First Per-Page Schema
1
Open Schemas Tab
Click the "Schemas" tab in the Sekhlo Schema Manager meta box
2
Add Schema
Click "Add Schema" and enter a name (e.g., "Article Schema")
3
Paste Code or Use Template
Select a pre-built template or paste your own JSON-LD code
4
Publish
Click "Add Schema" then publish your post
💡 Example Article Schema
Here's a simple Article schema to get you started:
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "Your Article Title",
"description": "Article description",
"author": {
"@type": "Person",
"name": "Author Name"
},
"datePublished": "2026-01-24"
}
✅ Next Steps
- Build your Entity in the Entity tab (most important for AI search)
- Add Google Analytics in Settings → Sekhlo Schema (Headers & Footers)
- Use Templates tab for per-page schema types
- Try AI Prompt Generator for custom, context-aware schemas
- Set up Topic Clusters to signal content hierarchy
🏛️ Entity Builder Guide
🎯 What is an Entity?
An entity is a uniquely identifiable person, business, or organization that AI and search engines can recognize and verify across the web. Strong entities with matching profiles on LinkedIn, Wikipedia, Google Business, etc. rank better in AI-generated answers, knowledge panels, and local search.
The 6 Entity Types
👤
Person
Generates Person schema with sameAs profiles
🏢
Organization
Generates Organization schema using site URL
🏪
Local Business
Generates LocalBusiness with postal address
📰
News / Blog
Generates NewsMediaOrganization schema
🛒
E-Commerce
Generates Store schema with currency/shipping
🎓
Educational
Generates EducationalOrganization schema
Entity Authority Score
The score counts how many recognized platforms you have linked in your sameAs profiles. The live checklist shows exactly what is missing and why each platform matters.
🔴
Weak
0–2 profiles connected
🟡
Building
3–5 profiles connected
🟢
Strong
6+ profiles connected
Local Business Entity — Fields
Business Category: Restaurant, Clinic, Retail, Salon, Hotel, Law Firm, Real Estate, Auto Repair, Gym, Other
Phone & WhatsApp: Separate fields — WhatsApp especially important for Pakistan & South Asia
Address: Street, City, Country with PostalAddress schema generation
Opening Hours: Standard format (Mo-Sa 09:00-21:00)
Price Range: $, $$, $$$, $$$$
Google Maps URL & Google Business Profile URL
Social Profiles: LinkedIn, Facebook, Instagram
News / Blog Entity — Fields
Publication Name & URL: Pre-filled from site settings
Language: English, Urdu, or Both
Topics Covered: Comma-separated (Politics, Technology, Sports)
Editor Name: Auto-generates publishingPrinciples URL
Social Profiles: LinkedIn, Twitter/X, Facebook
E-Commerce Store Entity — Fields
Store Name & URL
Currency: PKR, USD, AED, GBP, EUR
Shipping Countries: Pakistan, UAE, UK (comma separated)
Return Policy URL
Customer Service Phone
Social Profiles: LinkedIn, Facebook, Instagram
Topic Cluster Builder
Defines content hierarchy for AI topical authority signals:
Pillar Page: Main topic page — other cluster pages point to this
Cluster Page: Belongs to a pillar — assigns parent relationship via isPartOf
Auto Schema: Generates WebPage schema with isPartOf referencing the pillar URL
Cluster Members List: Pillar pages show all cluster pages pointing to them
💡 Entity AI Prompt
The Entity tab includes a dedicated AI Prompt section. Click "Generate AI Prompt for Entity Analysis" to get a customized prompt for ChatGPT/Claude that includes your entity data, content excerpt, and categories. The AI can extract missing entity signals and generate optimized sameAs schema.
📚 Complete Features Guide
🎯 8 Powerful Tabs
Sekhlo Schema Code includes 8 specialized tabs inside the post/page editor meta box, each designed for a specific purpose.
1. Schemas Tab
Purpose: Manage all your per-page Schema.org JSON-LD markup
Add Schema: Create new schemas with custom names and JSON-LD code
Enable/Disable: Toggle schemas on/off without deleting
Edit Inline: Modify schema name and code directly
Bulk Actions: Enable all, disable all, or delete all at once
Import/Export: Backup schemas or transfer between sites
Real-time Validation: Instant JSON syntax checking as you type
2. Entity Tab (New in v2.0)
Purpose: Build and manage site-wide entity authority for AI search engines
6 Entity Types: Person, Organization, Local Business, News/Blog, E-Commerce, Educational
Entity Score: Live completeness checklist with improvement tips
Sitewide Injection: Data saved to wp_options and injected on all pages
Topic Cluster: Define Pillar/Cluster page hierarchy
Entity AI Prompt: Generate analysis prompt for ChatGPT/Claude
Paste Schema: Paste AI-generated schema directly into the entity field
3. AI Prompt Generator
Purpose: Generate customized AI prompts for ChatGPT, Claude, or Gemini
Auto-Generated: Includes page title, URL, content, meta tags, and site info
One-Click Copy: Copy prompt to clipboard with a single click
Direct Links: Quick access to ChatGPT, Gemini, and Claude
4. Internal Links Tab
Purpose: Get AI-powered internal linking suggestions
Sitemap Integration: Works with your WordPress sitemap for accurate suggestions
Relevance Scoring: Shows how relevant each suggestion is
AI Prompt: Generate comprehensive internal linking strategy with AI
5. Meta Title & Description
Purpose: Complete SEO meta tag management
Meta Title & Description: Custom overrides with character counters
URL Slug: Optimize your page URL
SERP Preview: Live preview of how your page appears in Google
OpenGraph Tags: Auto-generates og:title, og:description, og:image
6. Templates Tab
Purpose: Quick-start with 12 professionally crafted schema templates
📋 Available Templates
✓ Article Schema
✓ BlogPosting Schema
✓ Organization Schema
✓ Person Schema
✓ WebPage Schema
✓ BreadcrumbList
✓ FAQPage Schema
✓ HowTo Schema
✓ Product Schema
✓ Review Schema
✓ LocalBusiness
✓ Event Schema
7. Preview Tab
Purpose: Preview your schemas before publishing
SERP Preview: See how your page appears in Google search results
Raw JSON-LD: View combined code from all enabled schemas
Real-Time Updates: Automatically updates as you make changes
8. Testing Tab
Purpose: Validate and optimize your schemas
Google Rich Results: Test with Google's official validation tool
Schema.org Validator: Validate against official specifications
AI Optimization Score: Get scored on AI search engine readiness (0–100%)
Conflict Detector: Identifies schema conflicts with other SEO plugins
💡 Pro Tip
Start with the Entity tab to set your sitewide identity. Then add per-page schemas with Templates. Finally optimize meta tags and test everything with the Testing tab. Use all 8 tabs together for maximum AI search visibility.
🤖 Using AI Prompt Generators
⚡ Harness the Power of AI
Generate perfect Schema.org markup using ChatGPT, Claude, or Gemini. The plugin creates customized prompts that include all your page data and detailed instructions for optimal results.
Three Prompt Types
Schema Generator Prompt: Generates the best JSON-LD schema markup for your page based on content type
Meta Tags Prompt: Generates optimized meta title, description, and URL slug with CTR-focused copy
Internal Links Prompt: Analyzes your sitemap and content to suggest the best internal links
Entity AI Prompt: Extracts entity signals and generates optimized sameAs schema (in Entity tab)
How to Use AI Generators
1
Open Prompt Generator Tab
Navigate to the "Prompt Generator" tab in the meta box
2
Copy the Prompt
Click "Copy Prompt" — it's auto-generated with your page data, title, URL, content
3
Open AI Platform
Click the ChatGPT, Claude, or Gemini quick link
4
Paste & Submit
Paste the prompt and wait for the AI to generate your schema code
5
Add to Plugin
Copy the JSON-LD from AI, paste it in the Schemas tab, and click "Add Schema"
⚠️ Best Practices
- Review AI Output: Always review AI-generated code before adding to your site
- Customize Data: Replace placeholder values with your specific information
- Test Thoroughly: Use Google Rich Results Test to validate schemas
- Use ChatGPT-4o or Claude Sonnet for best results
📋 Schema Templates
Article Schema
Use for: Blog posts, news articles, editorial content
Benefits: Rich snippets with author, date, and image in search results
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "%title%",
"description": "Article description",
"image": "image-url",
"author": {
"@type": "Person",
"name": "Author Name"
},
"publisher": {
"@type": "Organization",
"name": "%site_title%",
"logo": {
"@type": "ImageObject",
"url": "logo-url"
}
},
"datePublished": "2026-01-24",
"dateModified": "2026-01-24"
}
FAQPage Schema
Use for: FAQ pages, Q&A content
Benefits: Expandable FAQ rich snippets directly in Google search results
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "What is your question?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Your answer here."
}
}
]
}
LocalBusiness Schema
Use for: Local businesses, stores, restaurants
Benefits: Google Maps integration, local search visibility, opening hours in results
Product Schema
Use for: Product pages, e-commerce
Benefits: Price, availability, and star ratings in search results
Variable Replacement
Templates automatically replace these variables:
%title% → Your page title%post_url% → Your page URL%site_title% → Your website name%site_url% → Your website URL
🔧 Troubleshooting Guide
Entity Schema Not Injecting Sitewide
Solution:
- Ensure you clicked "Save & Inject to <head> (All Pages)" — not just "Generate Schema"
- Clear your site cache (caching plugin + server cache)
- View page source and search for "Sekhlo Entity Schema" comment
- Entity schema requires a non-empty name field — check that the name is filled in
Header/Footer Scripts Not Appearing
Solution:
- Go to Settings → Sekhlo Schema and confirm the scripts are saved
- Clear your caching plugin cache
- Scripts only appear on the frontend — not in wp-admin
- If using a page builder, confirm it fires
wp_head and wp_footer hooks
Schemas Not Showing on Frontend
Solution:
- Check if schema is enabled (toggle switch should be ON)
- Clear your site cache
- View page source and search for "application/ld+json"
- Ensure you're viewing a published post/page (not draft)
Invalid JSON Error
Common causes:
- Missing comma between properties
- Extra comma after last property
- Unescaped quotes inside strings
- Missing closing brackets or braces
Solution: Use the built-in validator or paste code into JSONLint.com
Plugin Conflicts with Yoast / Rank Math
Solution:
- Disable schema output in Yoast SEO (SEO → Search Appearance → Schema)
- Disable schema output in Rank Math (Rank Math → Titles & Meta → Schema)
- Use the Conflict Detector tab to identify duplicate schemas automatically
Meta Box Not Visible
Solution:
- In Gutenberg: Click three dots (⋮) → Options → Panels
- Ensure "Sekhlo Schema Manager" is checked
- In Classic Editor: Click "Screen Options" at top and check the box
Still Need Help?
