اپنی Next.js سائٹ میں سٹرکچرڈ ڈیٹا (JSON-LD) کو کیسے شامل اور اس کی تصدیق کریں۔

سٹرکچرڈ ڈیٹا ہمیشہ سرچ انجنوں کے لیے اہم رہا ہے۔ جب سرچ انجن کسی صفحہ کو پڑھتا ہے، تو اسے HTML نظر آتا ہے: عنوان، کچھ پیراگراف، تاریخیں، نام وغیرہ۔

سٹرکچرڈ ڈیٹا آپ کو براہ راست بتاتا ہے کہ وہ حصہ کیا ہے۔ یہ صفحہ مضمون ہے، یہ سرخی ہے، یہ اس شخص نے لکھا ہے، اور اس تاریخ کو شائع ہوا ہے۔

میرے نزدیک سرچ انجن آپٹیمائزیشن ایک باکس نہیں ہے جسے آخر میں چیک کیا جائے۔ میں چاہتا ہوں کہ میں جو پروڈکٹس اور سائٹس بناتا ہوں ان کو دریافت کیا جائے، اور دریافت ہونے پر، صحیح طریقے سے سمجھا جائے۔

اس لیے میں ہر اس صفحہ پر سٹرکچرڈ ڈیٹا شامل کرتا ہوں جو معنی خیز ہے۔ اور مجھے لگتا ہے کہ یہ زیادہ متعلقہ ہوتا جا رہا ہے کیونکہ AI سسٹمز ویب مواد کے بارے میں سوالات کا جواب دینا شروع کر دیتے ہیں۔

Next.js ایپ میں ایسی کوئی چیز نہیں ہے جو آپ کے لیے اس ڈیٹا کو لکھے۔ بس اسے ایک چھوٹے JSON بلاک کے طور پر براہ راست اس صفحہ پر شامل کریں جس کی آپ کو ضرورت ہے۔

اس ٹیوٹوریل میں، آپ سیکھیں گے کہ ساختی ڈیٹا کیا ہے اور JSON-LD کیسے کام کرتا ہے۔ پھر اسے اپنے Next.js ایپ روٹر پروجیکٹ میں شامل کریں۔ JsonLd صفحہ پیش کرتا ہے اسی مواد کے ساتھ بنایا گیا تمام ڈیٹا، تنظیم اور مضمون کے ڈیٹا کے ساتھ استعمال کرنے کے لیے محفوظ اجزاء، اور ہر تعمیر کے بعد ہر چیز کی تصدیق کرنے کے لیے چیک کرتا ہے۔

انڈیکس

شرطیں

پیروی کرنے کے لیے آپ کو ضرورت ہو گی:

App Router اور TypeScript کا استعمال کرتے ہوئے Next.js ایپ۔ اس مضمون کے کوڈ کو Next.js 16.4.0 اور React 19.3 پر جانچا گیا ہے۔
سرور کے اجزاء اور متحرک راستوں کا بنیادی علم۔
کہ schema-dts ایک پیکیج جو ساختی ڈیٹا کے لیے TypeScript کی اقسام فراہم کرتا ہے۔

انسٹال کریں schema-dts اسے ترقی کے انحصار کے طور پر استعمال کیا جاتا ہے کیونکہ یہ صرف درج ذیل اقسام فراہم کرتا ہے۔

npm install -D schema-dts

مثال ایک بلاگ کا استعمال کرتی ہے۔ جہاں بھی دیکھو getPost()CMS، ڈیٹا بیسز اور مارک ڈاؤن فائلوں سمیت اپنے ڈیٹا کے ذرائع استعمال کریں۔

ڈویلپرز کے لیے سٹرکچرڈ ڈیٹا کی بنیادی باتیں

اگر آپ نے پہلے کبھی بھی سٹرکچرڈ ڈیٹا استعمال نہیں کیا ہے، تو یہ سیکشن آپ کو مندرجہ ذیل کوڈ کو سمجھنے میں مدد کے لیے کافی معلومات فراہم کرتا ہے۔

سٹرکچرڈ ڈیٹا اور JSON-LD کیا ہیں؟

سٹرکچرڈ ڈیٹا کسی صفحہ کے مواد کی مشین کے ذریعے پڑھنے کے قابل تفصیل ہے۔ یہ چیک کرنے کے لیے سرچ انجن کو چھوڑنے کے بجائے کہ "Jane Doe” مصنف ہے اور "2026-09-01” اشاعت کی تاریخ ہے، یہ اس فارمیٹ میں بیان کرتا ہے کہ پروگرام بغیر اندازہ لگائے پڑھ سکتا ہے۔

آپ جو الفاظ استعمال کرتے ہیں وہ Schema.org سے لیے گئے ہیں، اقسام کی ایک مشترکہ ذخیرہ الفاظ، جیسے Article، Person اور Organization) اور ان کی خصوصیات، جیسے headline، author اور datePublished)۔ اس کی ابتدا گوگل، مائیکروسافٹ، یاہو، اور یانڈیکس سے ہوئی ہے، اور یہ وہ ذخیرہ الفاظ ہے جس کی سرچ انجن توقع کرتے ہیں۔

JSON-LD (JavaScript Object Notation for Linked Data) اس ڈیٹا کو لکھنے کا ایک طریقہ ہے۔ یہ ایک W3C معیار ہے اور ویب صفحات پر ایک منفرد قسم کے اسکرپٹ ٹیگ میں موجود ہے۔

براؤزر اس اسکرپٹ کو نہیں چلاتے ہیں۔ غیر جاوا اسکرپٹ کی قسمیں ٹیگز کو اس میں تبدیل کرتی ہیں جسے ایچ ٹی ایم ایل اسٹینڈرڈ ڈیٹا بلاک کہتا ہے "جس پر صارف ایجنٹ کے ذریعہ کارروائی نہیں کی جاتی ہے، بلکہ اس کے بجائے مصنف اسکرپٹ یا دوسرے ٹول کے ذریعہ”۔

موجودہ HTML عناصر میں صفات شامل کرنے کے لیے دو مختلف فارمیٹس ہیں: مائیکرو ڈیٹا اور RDFa۔ گوگل ان تینوں کو سپورٹ کرتا ہے، لیکن JSON-LD تجویز کرتا ہے "اگر آپ کی سائٹ کی ترتیبات اس کی اجازت دیتی ہیں۔” React ڈویلپرز کے لیے، JSON-LD بھی موزوں ہے۔ JSON-LD ایک سادہ آبجیکٹ ہے جو ڈیٹا سے بنایا گیا ہے، JSX سے الگ، جو صفحہ کو رینڈر کرتا ہے۔

JSON-LD بلاکس کیسے بنائے جاتے ہیں۔

بلاگ پوسٹ کے لیے JSON-LD بلاک یہ ہے:

{
  "@context": "https://schema.org",
  "@type": "BlogPosting",
  "headline": "How Caching Works in Next.js",
  "datePublished": "2026-09-01T09:00:00.000Z",
  "author": {
    "@type": "Person",
    "name": "Jane Doe"
  },
  "publisher": {
    "@type": "Organization",
    "@id": "https://example.com/#organization",
    "name": "Example Dev Blog"
  }
}

سے شروع ہونے والی چابیاں @ JSON-LD کلیدی لفظ۔ باقی Schema.org پراپرٹیز ہیں۔

@context یہ آپ کو بتاتا ہے کہ نام کس لفظ سے آیا ہے۔ Schema.org کے لیے https://schema.org.
@type یہ آپ کو بتاتا ہے کہ کیا ہو رہا ہے۔ BlogPosting Schema.org کی ایک زیادہ مخصوص قسم۔ Article.
headline، datePublished اور author اس قسم کی ایک خاصیت۔ اوصاف میں متن، تاریخیں، یو آر ایل، یا دیگر اقسام کی اشیاء شامل ہو سکتی ہیں، جیسے Person کو author.
@id چیزوں کو منفرد نام دیں۔ عام طور پر URL ہے: # ٹکڑا یہ پبلشر کو اسی تنظیم کے طور پر دکھاتا ہے جو ہوم پیج پر دوسرے بلاکس میں بیان کیا گیا ہے۔ @id.

مندرجہ ذیل کوڈ چاروں کو استعمال کرتا ہے۔

سٹرکچرڈ ڈیٹا، JSON-LD، Schema.org، اور بھرپور نتائج

چونکہ یہ چار شرائط اکثر الجھ جاتی ہیں، ان کا تعلق یہ ہے:

اصطلاحات	یہ کیا ہے
منظم ڈیٹا	آئیڈیا: مشین سے پڑھنے کے قابل صفحہ کی تفصیل
Schema.org	ذخیرہ الفاظ: دستیاب اقسام اور خواص
JSON-LD	فارمیٹ: اپنے صفحہ پر تفصیل کیسے لکھیں۔
بھرپور نتائج	Google تلاش کی خصوصیات: بریڈ کرمبس یا پروڈکٹ کی قیمتیں اور درجہ بندی جیسا ساختی ڈیٹا آپ کے صفحات کے مطابق بہتر نتائج فراہم کرنے میں آپ کی مدد کر سکتا ہے۔

اس کا مطلب یہ ہے کہ اگر آپ JSON-LD میں Schema.org الفاظ کا استعمال کرتے ہوئے سٹرکچرڈ ڈیٹا لکھتے ہیں، تو Google اسے بھرپور نتائج ظاہر کرنے کے لیے استعمال کر سکتا ہے۔

سٹرکچرڈ ڈیٹا تلاش کے لیے کیا کرتا ہے اور کیا نہیں کرتا

گوگل کا کہنا ہے کہ وہ "صفحہ کے مواد کو سمجھنے” اور مارک اپ میں بیان کردہ لوگوں، کتابوں اور کمپنیوں کے بارے میں معلومات اکٹھا کرنے کے لیے سٹرکچرڈ ڈیٹا کا استعمال کرتا ہے۔ ہم اس کا استعمال یہ تعین کرنے کے لیے بھی کرتے ہیں کہ آیا کوئی صفحہ بھرپور نتائج کے لیے اہل ہے یا نہیں۔

اہلیت ایک اہم لفظ ہے۔ ایک درست JSON-LD چار وجوہات کی بنا پر بھرپور نتائج کی ضمانت نہیں دیتا:

ہر بھرپور نتیجہ کی اپنی مطلوبہ خصوصیات ہوتی ہیں جو اس خصوصیت کے لیے Google دستاویزات میں درج ہوتی ہیں۔ مارک اپ درست Schema.org ہو سکتا ہے لیکن پھر بھی غائب ہے۔
گوگل فیصلہ کرتا ہے کہ خصوصیات کو ظاہر کرنا ہے یا نہیں۔ سٹرکچرڈ ڈیٹا گائیڈلائنز میں کہا گیا ہے کہ "گوگل اس بات کی ضمانت نہیں دیتا کہ سٹرکچرڈ ڈیٹا تلاش کے نتائج میں ظاہر ہوگا، چاہے صفحہ صحیح طریقے سے مارک اپ کیا گیا ہو۔”
مارک اپ صفحہ پر دکھائے گئے مواد کی وضاحت کرے۔ وہی رہنما خطوط بیان کرتے ہیں، "ایسے مواد کو نشان زد نہ کریں جو صفحہ کے قارئین کو نظر نہیں آتا ہے۔”
کچھ قسمیں اب بھرپور نتائج پیدا نہیں کرتی ہیں۔ Google 7 مئی 2026 کو اکثر پوچھے گئے سوالات کے بھرپور نتائج دکھانا بند کر دے گا اور 2023 میں کس طرح سے بھرپور نتائج دکھانا بند کر دے گا۔

سٹرکچرڈ ڈیٹا صرف درجہ بندی کو بہتر نہیں کرتا ہے۔ جیسا کہ گوگل کے جان مولر نے 2025 میں کہا تھا، "سٹرکچرڈ ڈیٹا آپ کی سائٹ کی رینک کو بہتر نہیں بناتا۔”

AI تلاش کے بارے میں کیا خیال ہے؟ گوگل کا کہنا ہے کہ AI خصوصیات میں ظاہر ہونے کے لیے "کوئی خاص Schema.org ڈھانچہ دار ڈیٹا نہیں ہے جسے شامل کرنے کی ضرورت ہے”۔ Bing کے ویب ماسٹر رہنما خطوط یہ بتاتے ہیں کہ ساختی ڈیٹا "زیادہ وضاحت کی حمایت کر سکتا ہے، لیکن مرئیت کی ضمانت نہیں دیتا۔” OpenAI، Anthropic، اور Perplexity اس کے استعمال کی دستاویز نہیں کرتے ہیں۔ کرالر دستاویزات کرالر تک رسائی کا احاطہ کرتی ہیں، مارک اپ نہیں۔

ابھی AI تلاش کے ارد گرد بہت زیادہ ہائپ ہے، اور اس میں سے کچھ جائز ہے۔ لیکن میرا استدلال کسی ایک کمپنی کے وعدوں پر منحصر نہیں ہے۔

میں چاہتا ہوں کہ میرا مواد جتنا بھی ہو سکے قابل فہم ہو جو بھی سسٹم اسے پڑھتا ہے، چاہے وہ سرچ انجن ہو یا AI ٹول۔ سٹرکچرڈ ڈیٹا آپ کے صفحہ کی ایک واضح اور درست وضاحت ہے، جو کوئی بھی اسے پڑھنا چاہے گا۔ AI جوابات حاصل کرنے کے لیے اسے ایک چال نہ سمجھیں۔

یہ اصل میں کتنا عام ہے؟ Greadme کی 2026 کی اسٹیٹ آف ویب سائٹس کی رپورٹ کے مطابق (ایک ویب سائٹ آڈٹ ٹول جسے میں نے بنایا تھا)، 387 آڈٹ شدہ ہوم پیجز میں سے 63% میں سٹرکچرڈ ڈیٹا تھا۔ ان میں سے اکثر اچھی طرح سے منظم ہیں. ان سائٹس میں سے 91 فیصد نے غلطیوں کے بغیر تصدیق پاس کی۔

لیکن ان میں سے 16٪ نے پھر بھی اعلان کیا۔ FAQPageیہ وہ قسم ہے جسے Google 2023 میں حکومت اور صحت کی سائٹوں تک بھرپور نتائج کو محدود کرنے کے بعد استعمال کرنا بند کر دے گا۔ درست نہیں ہے جیسا کہ مفید ہے۔

ایک محفوظ JsonLd جزو کیسے بنایا جائے۔

Next.js JSON-LD گائیڈ سٹرکچرڈ ڈیٹا کی وضاحت کرتا ہے ”

عام JSON.stringifyسرور بھیجتا ہے:

"}

براؤزر ابتدائی طور پر JSON-LD ٹیگز کو ختم کر دیتے ہیں۔ . Then it finds a second, ordinary script tag and runs it. That’s a cross-site scripting (XSS) attack, and your structured data is now broken JSON as well.


I ran that page through jsdom, which parses HTML the way the HTML standard specifies. The alert ایک بار بھاگا، JSON.parse JSON-LD "JSON میں غیر ختم شدہ سٹرنگ” کی وجہ سے ناکام ہو گیا۔
فرار کے ساتھ، مساوی قدر ہے:
\u003cscript>alert(document.cookie)\u003c/script>"}]]>

موجود نہیں ہے  left for the browser to find. \u003c یہ خود JSON میں فرار ہے۔ <، لہذا کوئی بھی JSON تجزیہ کار اسے اصل حروف کے طور پر پڑھتا ہے۔ اسی امتحان میں کچھ بھی نہیں بھاگا۔ JSON.parse اس نے CMS میں محفوظ کردہ صحیح نام واپس کر دیا۔

صفحہ کو توڑنے کے لیے آپ کو حملہ آور کی ضرورت نہیں ہے۔ ایچ ٹی ایم ایل کا معیار بھی درج کرتا ہے: