Catatan Lapangan

Metadata 101: Kenalin Situsmu ke Web Biar Gak Salah Paham

Penulis
Indra Sanjaya
Rilis
30 Okt 2026
Lama Baca
8 mnt
Tag
web-developmentseometadatanextjs

Website-mu bisa aja ngebut dan cakep banget, tapi tetap gak ada yang nemuin. Hasil pencarian cuma nampilin cuplikan kosong, link yang dishare muncul sebagai URL polos tanpa gambar, dan crawler malah nge-index versi halaman yang salah. Itu semua bukan soal desain, bro. Itu soal metadata.

Beberapa waktu lalu aku bikin carousel singkat soal ini di LinkedIn. Nah, artikel ini versi panjangnya: metadata itu fungsinya apa aja, siapa yang baca, dan gimana cara pasangnya yang bener di Next.js App Router.

FIG. 00 — Postingan LinkedIn aslinya
Slide pertama carousel LinkedIn: 'Your website has 3 audiences'.
Postingan yang jadi awal mula artikel ini. Slide pertamanya nanya satu hal yang dijawab sepanjang tulisan ini: sebenarnya website-mu itu ditulis buat siapa sih?

FIG. 01Satu Halaman, Tiga Penonton

Halamanmu dibaca tiga "penonton" yang beda banget, dan cuma satu yang punya mata.

Metadata itu bagian halaman yang ditulis buat penonton nomor dua dan tiga. Letaknya di <head>, gak keliatan sama pengunjung, dan itu satu-satunya cara buat ngasih tau mesin halaman ini isinya apa, bukan dibiarin nebak-nebak sendiri.

FIG. 01 — Satu halaman, tiga penonton
YOUR PAGERendered UIlayout · copy · visuals<head> metadata<title> · meta descriptioncanonical · Open GraphJSON-LD structured dataWHO READS WHATHumanssee the rendered UIjudge it in secondsSearch enginesread the title and description,follow the canonical,parse structured dataCrawlers & platformsbuild link previews fromOpen Graph and Twitter Cards
Tampilan yang dirender itu cuma separuh dari sebuah halaman. Di <head> ada lapisan info kedua yang gak pernah dilihat manusia, tapi jadi andalan search engine dan crawler preview link.
→ 01

Kalau kamu gak jelasin halamanmu ke mesin, mereka bakal jelasin sendiri, dan hasilnya jarang yang enak dilihat.

FIG. 02Tiap Sinyal Kerjanya di Mana

"Metadata" itu bukan satu mekanisme doang. Tiap sinyal kerja di tahap yang beda dalam perjalanan sebuah halaman, dan kebanyakan salah kaprah muncul gara-gara ketuker-tuker.

FIG. 03 — Tiap sinyal kerjanya di mana
STAGE 01Discoversitemap.xmlinternal linksbacklinksSTAGE 02Crawlrobots.txtallow / disallowcontrols fetchingSTAGE 03Index<title>meta descriptioncanonical URLmeta robots: noindexstructured dataSTAGE 04DisplayOpen GraphTwitter Cards→ link previewstitle + description→ search snippets
Metadata itu bukan satu mekanisme, tapi beberapa, masing-masing kerja di tahap yang beda. robots.txt ngatur pengambilan halaman, bukan pengindeksan. Halaman yang diblokir dari crawling gak akan pernah keliatan punya noindex, jadi dua hal ini jangan sampai ketuker.

Sebuah halaman ditemukan (sitemap, link), di-crawl (diambil, tunduk sama robots.txt), diindeks (dipahami dan disimpan), terus akhirnya ditampilin (sebagai hasil pencarian atau preview link). Satu hal yang wajib kamu inget: robots.txt itu ngatur crawling, bukan pengindeksan. Kalau kamu blokir halaman di sana, crawler gak akan pernah liat tag noindex-nya, dan URL itu masih bisa muncul di hasil pencarian. Mau halaman gak masuk indeks? Izinin crawling, terus pakai noindex.

FIG. 03Lima Hal yang Wajib Ada

Title dan meta description

<title> itu judul hasil pencarianmu sekaligus nama tab browser. Bikin yang spesifik dan gak kepanjangan biar gak kepotong, kira-kira 50 sampai 60 karakter. Meta description itu pitch-mu di bawahnya. Dia gak langsung ngaruh ke peringkat, dan search engine boleh aja nulis ulang keduanya, tapi deskripsi yang jelas itulah yang bikin orang mau klik.

Oh ya, Google juga udah gak peduli sama tag lawas meta keywords. Skip aja.

Canonical URL

Konten yang sama sering nongol di beberapa alamat: pakai atau tanpa www, pakai parameter tracking, pakai atau tanpa garis miring di ujung. Canonical URL ngasih tau search engine mana yang jadi versi utama, jadi sinyalnya numpuk jadi satu, bukan kepecah-pecah. Ini sifatnya petunjuk, bukan perintah, dan harus diatur per halaman. Canonical yang cuma diset sekali di layout bakal ngarahin semua halaman ke URL yang sama, dan itu lebih parah daripada gak punya canonical sama sekali.

Open Graph dan Twitter Cards

Tag Open Graph (og:title, og:description, og:image, og:url) yang ngatur apa yang muncul waktu link-mu dishare. Pakai URL gambar absolut dengan ukuran sekitar 1200×630. Platform nge-cache preview dengan rajin banget, jadi abis ngubah tag, scrape ulang URL-nya lewat debugger platform (LinkedIn Post Inspector, Facebook Sharing Debugger).

FIG. 04 — Bedah preview link
WITHOUT METADATAno imageyoursite.com/post(no title)(no description)the platform has to guess+ metaWITH METADATAog:image · 1200×630Metadata 101: Tell the WebWhat Your Site Isog:titleTitle, description, Open Graph and more.og:descriptionyoursite.comog:url
Kiri: tanpa tag yang bisa dipakai, platform cuma bisa nebak dari URL. Kanan: link yang sama setelah og:image, og:title, dan og:description ada. Platform mungkin pakai <title> dan meta description sebagai cadangan, tapi hasilnya gak menentu. og:image yang eksplisit itu satu-satunya cara andal buat ngatur gambar preview.

Structured data

Structured data, idealnya pakai JSON-LD, ngejelasin entitas secara gamblang: halaman ini adalah sebuah Article, ditulis sama Person ini, terbit di tanggal ini. Ini bantu search engine ngerti halamanmu dan bisa bikin halaman layak dapet rich result, walaupun gak ada jaminan.

FIG. 04Cara Pasangnya di Next.js

App Router udah punya Metadata API bawaan, jadi semua ini gak perlu nulis tag <head> manual. Mulai dari default satu situs di root layout:

LISTING 01 — default satu situs di app/layout.tsx
import type { Metadata } from "next";
 
export const metadata: Metadata = {
  metadataBase: new URL("https://example.com"),
  title: {
    default: "Your Name — Software Engineer",
    template: "%s | Your Name",
  },
  description: "One clear sentence about who you are and what you build.",
  openGraph: {
    type: "website",
    siteName: "Your Name",
    images: ["/og-image.png"],
  },
  twitter: { card: "summary_large_image" },
};

metadataBase bikin kamu bisa pakai path relatif di tempat lain; Next.js yang bakal ngubahnya jadi URL absolut, yang emang dibutuhin crawler sosial. Abis itu timpa per halaman pakai generateMetadata, sekalian sama canonical-nya:

LISTING 02 — metadata per halaman buat dynamic route
import type { Metadata } from "next";
 
export async function generateMetadata({
  params,
}: {
  params: Promise<{ slug: string }>;
}): Promise<Metadata> {
  const { slug } = await params;
  const post = await getPost(slug);
 
  return {
    title: post.title,
    description: post.description,
    alternates: { canonical: `/articles/${slug}` },
    openGraph: {
      type: "article",
      title: post.title,
      description: post.description,
      publishedTime: post.publishedAt,
      images: [post.ogImage ?? "/og-image.png"],
    },
  };
}

Satu jebakan nih: field metadata yang bersarang digabungnya shallow. Kalau satu halaman definisiin openGraph, seluruh objek openGraph dari layout langsung ketimpa, jadi tulis ulang field (kayak siteName) yang masih kamu mau.

Tambahin structured data sebagai script JSON-LD, dengan < di-escape biar kontennya gak bisa nyelonong keluar dari tag:

LISTING 03 — JSON-LD buat Article
const jsonLd = {
  "@context": "https://schema.org",
  "@type": "Article",
  headline: post.title,
  description: post.description,
  datePublished: post.publishedAt,
  author: { "@type": "Person", name: "Your Name" },
};
 
export default function Page() {
  return (
    <script
      type="application/ld+json"
      dangerouslySetInnerHTML={{
        __html: JSON.stringify(jsonLd).replace(/</g, "\\u003c"),
      }}
    />
  );
}

Terakhir, dua file yang jadi penunjuk jalan buat crawler, dua-duanya dibikin lewat kode di Next.js:

LISTING 04 — app/robots.ts dan app/sitemap.ts
// app/robots.ts
import type { MetadataRoute } from "next";
 
export default function robots(): MetadataRoute.Robots {
  return {
    rules: { userAgent: "*", allow: "/" },
    sitemap: "https://example.com/sitemap.xml",
  };
}
 
// app/sitemap.ts
export default async function sitemap(): Promise<MetadataRoute.Sitemap> {
  const posts = await getAllPosts();
  return [
    { url: "https://example.com", lastModified: new Date() },
    ...posts.map((p) => ({
      url: `https://example.com/articles/${p.slug}`,
      lastModified: p.updatedAt ?? p.publishedAt,
    })),
  ];
}

FIG. 05Use Case: Link yang Keliatan Mati Suri

Skenario yang sering banget kejadian: kamu rilis proyek portfolio terus dishare di LinkedIn. Postingannya banyak yang liat, tapi yang klik hampir nol. Previewnya cuma kotak abu-abu plus URL mentah.

Diagnosisnya selalu tiga pengecekan yang sama. Ada og:image dengan URL absolut gak? og:title udah diatur, atau platform masih pakai <title> generik sebagai cadangan? Previewnya udah keburu ke-cache sebelum kamu nambah tag? Solusinya: tambahin tag-nya, terus paksa scrape ulang. Kontennya gak berubah; halamannya aja yang akhirnya mulai kenalan.

FIG. 06Use Case: Dua URL, Satu Halaman

Kamu deploy blog, terus baru sadar artikel yang sama bisa dibuka di /articles/post, /articles/post/, dan /articles/post?utm_source=newsletter. Search engine liat tiga kandidat dan harus milih, sementara sinyal peringkat kayak backlink jadi kebagi-bagi ke ketiganya.

Canonical per halaman (alternates.canonical di generateMetadata) nunjuk ketiganya ke satu alamat. Ditambah sitemap yang isinya cuma URL canonical, kamu udah ngasih tau semua crawler dengan jelas versi mana yang dihitung.

FIG. 07Checklist Audit Kilat

Cek daftar ini di halaman mana pun sebelum rilis:

CekKenapa penting
<title> unik per halamanJudul hasil pencarian dan nama tab
Meta description, ~150 karakterCuplikan yang bikin orang klik
Canonical diatur per halaman, bukan di layoutBiar gak kena dilusi gara-gara URL duplikat
og:image absolut, ~1200×630Preview link yang bisa diandalkan
robots.txt gak ngeblokir halaman yang mau kamu noindexCrawling vs. pengindeksan
Sitemap isinya cuma URL canonicalPenemuan yang lebih cepat dan rapi
JSON-LD validPeluang dapet rich result
Preview di-scrape ulang abis ada perubahanPlatform nge-cache dengan rajin
→ 02

Metadata itu kerjaan paling murah di dunia web dev dengan efek paling panjang. Ditulis sekali, dan tiap crawler, platform, sama hasil pencarian bakal baca selamanya.

FIG. 08Bacaan Lanjutan

Semua sumber di bawah pakai bahasa Inggris ya.