1# JSON-LD Schema Templates
2 
3Ready-to-use JSON-LD structured data templates for SEO and GEO optimization.
4 
5---
6 
7## 1. FAQPage Schema (+40% AI Visibility)
8 
9**Best for:** FAQ sections, knowledge base pages, product pages with Q&A.
10 
11```json
12{
13  "@context": "https://schema.org",
14  "@type": "FAQPage",
15  "mainEntity": [
16    {
17      "@type": "Question",
18      "name": "What is [Your Product/Service]?",
19      "acceptedAnswer": {
20        "@type": "Answer",
21        "text": "[Comprehensive answer with statistics. According to X, 85% of users report Y benefit.]"
22      }
23    },
24    {
25      "@type": "Question",
26      "name": "How does [Product/Service] work?",
27      "acceptedAnswer": {
28        "@type": "Answer",
29        "text": "[Step-by-step explanation. First, you... Then... Finally...]"
30      }
31    },
32    {
33      "@type": "Question",
34      "name": "What are the benefits of [Product/Service]?",
35      "acceptedAnswer": {
36        "@type": "Answer",
37        "text": "[List key benefits with data. Users save an average of X hours per week.]"
38      }
39    },
40    {
41      "@type": "Question",
42      "name": "How much does [Product/Service] cost?",
43      "acceptedAnswer": {
44        "@type": "Answer",
45        "text": "[Pricing information. Plans start at $X/month with a free tier available.]"
46      }
47    },
48    {
49      "@type": "Question",
50      "name": "How do I get started with [Product/Service]?",
51      "acceptedAnswer": {
52        "@type": "Answer",
53        "text": "[Installation/signup instructions. Run: curl -fsSL example.com/install.sh | bash]"
54      }
55    }
56  ]
57}
58```
59 
60---
61 
62## 2. WebPage Schema
63 
64**Best for:** Standard content pages, landing pages.
65 
66```json
67{
68  "@context": "https://schema.org",
69  "@type": "WebPage",
70  "name": "[Page Title]",
71  "description": "[Page description, 150-160 characters]",
72  "url": "https://example.com/page",
73  "datePublished": "2024-01-15",
74  "dateModified": "2024-12-20",
75  "inLanguage": "en-US",
76  "isPartOf": {
77    "@type": "WebSite",
78    "name": "[Site Name]",
79    "url": "https://example.com"
80  },
81  "author": {
82    "@type": "Person",
83    "name": "[Author Name]",
84    "url": "https://example.com/about"
85  },
86  "publisher": {
87    "@type": "Organization",
88    "name": "[Organization Name]",
89    "logo": {
90      "@type": "ImageObject",
91      "url": "https://example.com/logo.png"
92    }
93  },
94  "speakable": {
95    "@type": "SpeakableSpecification",
96    "cssSelector": ["h1", ".summary", ".key-points"]
97  }
98}
99```
100 
101---
102 
103## 3. Article Schema
104 
105**Best for:** Blog posts, news articles, tutorials.
106 
107```json
108{
109  "@context": "https://schema.org",
110  "@type": "Article",
111  "headline": "[Article Title - Max 110 characters]",
112  "description": "[Article summary]",
113  "image": [
114    "https://example.com/image-1x1.jpg",
115    "https://example.com/image-4x3.jpg",
116    "https://example.com/image-16x9.jpg"
117  ],
118  "datePublished": "2024-01-15T08:00:00+00:00",
119  "dateModified": "2024-12-20T10:30:00+00:00",
120  "author": {
121    "@type": "Person",
122    "name": "[Author Name]",
123    "url": "https://example.com/author/name",
124    "jobTitle": "[Job Title]",
125    "worksFor": {
126      "@type": "Organization",
127      "name": "[Company]"
128    }
129  },
130  "publisher": {
131    "@type": "Organization",
132    "name": "[Publisher Name]",
133    "logo": {
134      "@type": "ImageObject",
135      "url": "https://example.com/logo.png",
136      "width": 600,
137      "height": 60
138    }
139  },
140  "mainEntityOfPage": {
141    "@type": "WebPage",
142    "@id": "https://example.com/article-url"
143  },
144  "keywords": ["keyword1", "keyword2", "keyword3"],
145  "articleSection": "[Category]",
146  "wordCount": 2500
147}
148```
149 
150---
151 
152## 4. SoftwareApplication Schema
153 
154**Best for:** Tools, apps, software products.
155 
156```json
157{
158  "@context": "https://schema.org",
159  "@type": "SoftwareApplication",
160  "name": "[App Name]",
161  "description": "[App description]",
162  "applicationCategory": "DeveloperApplication",
163  "operatingSystem": "Cross-platform",
164  "url": "https://example.com",
165  "downloadUrl": "https://example.com/download",
166  "softwareVersion": "1.0.0",
167  "releaseNotes": "https://example.com/changelog",
168  "screenshot": "https://example.com/screenshot.png",
169  "featureList": [
170    "Feature 1 description",
171    "Feature 2 description",
172    "Feature 3 description"
173  ],
174  "offers": {
175    "@type": "Offer",
176    "price": "0",
177    "priceCurrency": "USD",
178    "availability": "https://schema.org/InStock"
179  },
180  "aggregateRating": {
181    "@type": "AggregateRating",
182    "ratingValue": "4.8",
183    "ratingCount": "150",
184    "bestRating": "5",
185    "worstRating": "1"
186  },
187  "author": {
188    "@type": "Organization",
189    "name": "[Company Name]",
190    "url": "https://example.com"
191  }
192}
193```
194 
195---
196 
197## 5. Organization Schema
198 
199**Best for:** About pages, company pages.
200 
201```json
202{
203  "@context": "https://schema.org",
204  "@type": "Organization",
205  "name": "[Organization Name]",
206  "alternateName": "[Alternate Name]",
207  "url": "https://example.com",
208  "logo": "https://example.com/logo.png",
209  "description": "[Organization description]",
210  "foundingDate": "2024",
211  "founders": [
212    {
213      "@type": "Person",
214      "name": "[Founder Name]"
215    }
216  ],
217  "address": {
218    "@type": "PostalAddress",
219    "addressLocality": "[City]",
220    "addressRegion": "[State]",
221    "addressCountry": "[Country]"
222  },
223  "contactPoint": {
224    "@type": "ContactPoint",
225    "contactType": "customer service",
226    "email": "[email protected]"
227  },
228  "sameAs": [
229    "https://twitter.com/example",
230    "https://github.com/example",
231    "https://linkedin.com/company/example"
232  ]
233}
234```
235 
236---
237 
238## 6. Product Schema
239 
240**Best for:** E-commerce product pages.
241 
242```json
243{
244  "@context": "https://schema.org",
245  "@type": "Product",
246  "name": "[Product Name]",
247  "description": "[Product description]",
248  "image": [
249    "https://example.com/product-image-1.jpg",
250    "https://example.com/product-image-2.jpg"
251  ],
252  "sku": "[SKU]",
253  "brand": {
254    "@type": "Brand",
255    "name": "[Brand Name]"
256  },
257  "offers": {
258    "@type": "Offer",
259    "url": "https://example.com/product",
260    "priceCurrency": "USD",
261    "price": "99.99",
262    "priceValidUntil": "2025-12-31",
263    "availability": "https://schema.org/InStock",
264    "seller": {
265      "@type": "Organization",
266      "name": "[Seller Name]"
267    }
268  },
269  "aggregateRating": {
270    "@type": "AggregateRating",
271    "ratingValue": "4.5",
272    "reviewCount": "89"
273  },
274  "review": [
275    {
276      "@type": "Review",
277      "reviewRating": {
278        "@type": "Rating",
279        "ratingValue": "5",
280        "bestRating": "5"
281      },
282      "author": {
283        "@type": "Person",
284        "name": "[Reviewer Name]"
285      },
286      "reviewBody": "[Review text]"
287    }
288  ]
289}
290```
291 
292---
293 
294## 7. HowTo Schema
295 
296**Best for:** Tutorials, guides, how-to articles.
297 
298```json
299{
300  "@context": "https://schema.org",
301  "@type": "HowTo",
302  "name": "How to [Do Something]",
303  "description": "[Brief description of what this guide covers]",
304  "image": "https://example.com/how-to-image.jpg",
305  "totalTime": "PT15M",
306  "estimatedCost": {
307    "@type": "MonetaryAmount",
308    "currency": "USD",
309    "value": "0"
310  },
311  "supply": [
312    {
313      "@type": "HowToSupply",
314      "name": "[Required item 1]"
315    }
316  ],
317  "tool": [
318    {
319      "@type": "HowToTool",
320      "name": "[Required tool 1]"
321    }
322  ],
323  "step": [
324    {
325      "@type": "HowToStep",
326      "name": "Step 1: [Step Name]",
327      "text": "[Detailed step instructions]",
328      "image": "https://example.com/step-1.jpg",
329      "url": "https://example.com/guide#step1"
330    },
331    {
332      "@type": "HowToStep",
333      "name": "Step 2: [Step Name]",
334      "text": "[Detailed step instructions]",
335      "image": "https://example.com/step-2.jpg",
336      "url": "https://example.com/guide#step2"
337    },
338    {
339      "@type": "HowToStep",
340      "name": "Step 3: [Step Name]",
341      "text": "[Detailed step instructions]",
342      "image": "https://example.com/step-3.jpg",
343      "url": "https://example.com/guide#step3"
344    }
345  ]
346}
347```
348 
349---
350 
351## 8. BreadcrumbList Schema
352 
353**Best for:** All pages with navigation hierarchy.
354 
355```json
356{
357  "@context": "https://schema.org",
358  "@type": "BreadcrumbList",
359  "itemListElement": [
360    {
361      "@type": "ListItem",
362      "position": 1,
363      "name": "Home",
364      "item": "https://example.com"
365    },
366    {
367      "@type": "ListItem",
368      "position": 2,
369      "name": "[Category]",
370      "item": "https://example.com/category"
371    },
372    {
373      "@type": "ListItem",
374      "position": 3,
375      "name": "[Current Page]",
376      "item": "https://example.com/category/page"
377    }
378  ]
379}
380```
381 
382---
383 
384## 9. LocalBusiness Schema
385 
386**Best for:** Local business pages.
387 
388```json
389{
390  "@context": "https://schema.org",
391  "@type": "LocalBusiness",
392  "name": "[Business Name]",
393  "description": "[Business description]",
394  "image": "https://example.com/business-image.jpg",
395  "url": "https://example.com",
396  "telephone": "+1-555-555-5555",
397  "email": "[email protected]",
398  "address": {
399    "@type": "PostalAddress",
400    "streetAddress": "[Street Address]",
401    "addressLocality": "[City]",
402    "addressRegion": "[State]",
403    "postalCode": "[ZIP]",
404    "addressCountry": "US"
405  },
406  "geo": {
407    "@type": "GeoCoordinates",
408    "latitude": 37.7749,
409    "longitude": -122.4194
410  },
411  "openingHoursSpecification": [
412    {
413      "@type": "OpeningHoursSpecification",
414      "dayOfWeek": ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday"],
415      "opens": "09:00",
416      "closes": "17:00"
417    }
418  ],
419  "priceRange": "$$"
420}
421```
422 
423---
424 
425## 10. SpeakableSpecification (GEO Enhancement)
426 
427**Best for:** Voice search optimization, AI extraction.
428 
429```json
430{
431  "@context": "https://schema.org",
432  "@type": "WebPage",
433  "name": "[Page Title]",
434  "speakable": {
435    "@type": "SpeakableSpecification",
436    "cssSelector": [
437      "h1",
438      ".summary",
439      ".key-takeaways",
440      ".faq-answer"
441    ]
442  }
443}
444```
445 
446---
447 
448## Combined Schema Example
449 
450For a software product page with FAQ:
451 
452```json
453{
454  "@context": "https://schema.org",
455  "@graph": [
456    {
457      "@type": "WebPage",
458      "name": "OPC Skills - AI Agent Skills for Solopreneurs",
459      "description": "10+ agent skills for Claude Code, Cursor, Codex. Domain hunting, social media research, logo creation.",
460      "url": "https://opc.dev",
461      "dateModified": "2024-12-20",
462      "speakable": {
463        "@type": "SpeakableSpecification",
464        "cssSelector": ["h1", ".hero-description", ".faq-answer"]
465      }
466    },
467    {
468      "@type": "SoftwareApplication",
469      "name": "OPC Skills",
470      "applicationCategory": "DeveloperApplication",
471      "operatingSystem": "Cross-platform",
472      "offers": {
473        "@type": "Offer",
474        "price": "0",
475        "priceCurrency": "USD"
476      }
477    },
478    {
479      "@type": "FAQPage",
480      "mainEntity": [
481        {
482          "@type": "Question",
483          "name": "What is OPC Skills?",
484          "acceptedAnswer": {
485            "@type": "Answer",
486            "text": "OPC Skills is a collection of 10+ AI agent skills for solopreneurs, supporting Claude Code, Cursor, and Codex."
487          }
488        }
489      ]
490    },
491    {
492      "@type": "Organization",
493      "name": "OPC Skills",
494      "url": "https://opc.dev",
495      "sameAs": ["https://github.com/ReScienceLab/opc-skills"]
496    }
497  ]
498}
499```
500 
501---
502 
503## Validation Tools
504 
5051. **Google Rich Results Test**
506   ```
507   https://search.google.com/test/rich-results?url={your-url}
508   ```
509 
5102. **Schema.org Validator**
511   ```
512   https://validator.schema.org/?url={your-url}
513   ```
514 
5153. **Google Search Console**
516   - Check "Enhancements" for schema issues
517   - Monitor rich result performance
518