Skip to content
svead

Troubleshooting

My OpenGraph image isn’t showing

Check these:

  1. Image URL is absolute (not relative)
  2. Image is accessible (publicly available)
  3. Image meets size requirements (1200x630px recommended)
  4. Test with OpenGraph Debugger
TypeScript 
1// ✅ Good - absolute URL
2open_graph_image: 'https://example.com/image.jpg';
3
4// ❌ Bad - relative URL
5open_graph_image: '/image.jpg';

TypeScript errors with schema types

Make sure you’re using the correct import:

TypeScript 
1import type { SchemaOrgProps } from 'svead';
2
3// Use this type
4const schema: SchemaOrgProps['schema'] = {
5	'@type': 'BlogPosting',
6	// ...
7};

Schema validation errors

Common issues:

  1. Missing required fields: Check Schema.org documentation for required properties
  2. Wrong date format: Use ISO 8601 format (2023-08-22T10:00:00Z)
  3. Invalid URL: Use full URLs with protocol (https://example.com)
TypeScript 
1// ✅ Good
2datePublished: '2023-08-22T10:00:00Z';
3
4// ❌ Bad
5datePublished: '08/22/2023';

Multiple meta tags appearing

If you see duplicate meta tags:

  1. Check for conflicting SEO components
  2. Remove any manual <svelte:head> meta tags
  3. Use only one Head component per page

The @context is missing

The SchemaOrg component automatically adds @context if missing. If you need to add it manually:

TypeScript 
1const schema = {
2	'@context': 'https://schema.org',
3	'@type': 'WebPage',
4	// ...
5};

Images not appearing in structured data

Ensure images are in ImageObject format when required:

TypeScript 
1// ✅ Good - ImageObject format
2primaryImageOfPage: {
3  '@type': 'ImageObject',
4  url: 'https://example.com/image.jpg',
5}
6
7// ❌ Bad - string format (sometimes works, but not recommended)
8primaryImageOfPage: 'https://example.com/image.jpg'
All documentation