Catatan Lapangan

Metadata 101: Beri Tahu Web Apa Sebenarnya Situsmu

Penulis
Indra Sanjaya
Terbit
30 Okt 2026
Waktu Baca
8 mnt
Tag
web-developmentseometadatanextjs

Kamu bisa merilis website yang cepat dan indah, tetapi tetap tidak terlihat. Hasil pencarian menampilkan cuplikan kosong, tautan yang dibagikan muncul sebagai URL polos tanpa gambar, dan crawler mengindeks versi halaman yang salah. Semua itu bukan masalah desain. Itu masalah metadata.

Belum lama ini aku memposting carousel singkat tentang topik ini di LinkedIn. Artikel ini adalah versi panjangnya: apa fungsi tiap metadata, siapa yang membacanya, dan bagaimana mengimplementasikannya dengan benar di proyek Next.js App Router.

FIG. 00 — Postingan LinkedIn asli
Slide pertama carousel LinkedIn: 'Your website has 3 audiences'.
Postingan yang melatarbelakangi artikel ini. Slide pertama mengajukan pertanyaan yang dijawab oleh sisa tulisan ini: sebenarnya website-mu ditulis untuk siapa?

FIG. 01Satu Halaman, Tiga Pembaca

Halamanmu dibaca oleh tiga audiens yang sangat berbeda, dan hanya satu di antaranya yang punya mata.

Metadata adalah bagian halaman yang ditulis untuk audiens kedua dan ketiga. Ia berada di <head>, tidak terlihat oleh pengunjung, dan menjadi satu-satunya cara untuk memberi tahu mesin halaman ini apa secara sengaja, alih-alih membiarkan mereka menebak.

FIG. 01 — Satu halaman, tiga pembaca
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 hanyalah separuh dari sebuah halaman. Bagian <head> membawa lapisan informasi kedua yang tidak pernah dilihat manusia, tetapi menjadi andalan search engine dan crawler preview tautan.
→ 01

Kalau kamu tidak menjelaskan halamanmu kepada mesin, mereka akan menjelaskannya sendiri, dan hasilnya jarang menyenangkan.

FIG. 02Di Mana Tiap Sinyal Bekerja

"Metadata" bukan satu mekanisme tunggal. Sinyal yang berbeda bekerja di tahap yang berbeda dalam perjalanan sebuah halaman, dan mencampuradukkannya adalah sumber kesalahan paling umum.

FIG. 03 — Di mana tiap sinyal bekerja
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 bukan satu mekanisme, melainkan beberapa, masing-masing bekerja di tahap berbeda. robots.txt mengatur pengambilan halaman, bukan pengindeksan. Halaman yang diblokir dari crawling tidak akan pernah terlihat memuat noindex, jadi keduanya tidak boleh tertukar.

Sebuah halaman ditemukan (sitemap, tautan), di-crawl (diambil, tunduk pada robots.txt), diindeks (dipahami dan disimpan), lalu akhirnya ditampilkan (sebagai hasil pencarian atau preview tautan). Satu hal yang layak dihafal: robots.txt mengatur crawling, bukan pengindeksan. Kalau kamu memblokir sebuah halaman di sana, crawler tidak akan pernah melihat tag noindex-nya, dan URL itu tetap bisa muncul di hasil pencarian. Untuk menjauhkan halaman dari indeks, izinkan crawling dan gunakan noindex.

FIG. 03Lima Hal Esensial

Title dan meta description

<title> adalah judul hasil pencarianmu sekaligus label tab browser. Buat spesifik dan cukup pendek agar tidak terpotong, kira-kira 50 sampai 60 karakter. Meta description adalah pitch-mu di bawahnya. Ia tidak memengaruhi peringkat secara langsung, dan search engine boleh menulis ulang keduanya, tetapi deskripsi yang jelas adalah yang membuat orang mengklik.

Google juga mengabaikan tag lama meta keywords. Lewati saja.

Canonical URL

Konten yang sama sering hidup di beberapa alamat: dengan dan tanpa www, dengan parameter pelacakan, dengan atau tanpa garis miring di akhir. Canonical URL memberi tahu search engine mana yang menjadi versi utama, sehingga sinyalnya terkonsolidasi, bukan terpecah. Ini adalah petunjuk, bukan perintah, dan harus diatur per halaman. Canonical yang diatur sekali di layout bersama akan mengarahkan setiap halaman ke URL yang sama, dan itu lebih buruk daripada tidak punya canonical sama sekali.

Open Graph dan Twitter Cards

Tag Open Graph (og:title, og:description, og:image, og:url) mengatur apa yang ditampilkan platform ketika tautanmu dibagikan. Gunakan URL gambar absolut dengan ukuran sekitar 1200×630. Platform menyimpan cache preview dengan agresif, jadi setelah mengubah tag, scrape ulang URL-nya lewat debugger milik platform (LinkedIn Post Inspector, Facebook Sharing Debugger).

FIG. 04 — Anatomi preview tautan
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 hanya bisa menebak dari URL. Kanan: tautan yang sama setelah og:image, og:title, dan og:description tersedia. Platform mungkin memakai <title> dan meta description sebagai cadangan, tetapi hasilnya bervariasi. og:image yang eksplisit adalah satu-satunya cara andal untuk mengontrol gambar preview.

Structured data

Structured data, idealnya dalam bentuk JSON-LD, menjelaskan entitas secara eksplisit: halaman ini adalah sebuah Article, ditulis oleh Person ini, terbit pada tanggal ini. Ia membantu search engine menafsirkan halaman dan dapat membuatnya memenuhi syarat untuk rich result, meskipun tidak menjamin apa pun.

FIG. 04Implementasi di Next.js

App Router punya Metadata API kelas satu, jadi semua ini tidak perlu tag <head> yang ditulis manual. Mulailah dari default seluruh situs di root layout:

LISTING 01 — default seluruh 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 memungkinkan kamu memakai path relatif di tempat lain; Next.js mengubahnya menjadi URL absolut, yang dibutuhkan crawler sosial. Lalu timpa per halaman dengan generateMetadata, termasuk canonical-nya:

LISTING 02 — metadata per halaman untuk 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: field metadata bersarang digabung secara dangkal (shallow). Kalau sebuah halaman mendefinisikan openGraph, seluruh objek openGraph dari layout akan tergantikan, jadi tulis ulang field (seperti siteName) yang masih kamu inginkan.

Tambahkan structured data sebagai script JSON-LD, dengan < di-escape agar konten tidak bisa keluar dari tag:

LISTING 03 — JSON-LD untuk 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 memandu crawler, keduanya dihasilkan 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: Tautan yang Tampak Mati

Skenario yang umum: kamu merilis proyek portfolio lalu membagikannya di LinkedIn. Postingannya dilihat banyak orang, tetapi hampir tidak ada yang mengklik. Previewnya hanya kotak abu-abu dengan URL mentah.

Diagnosisnya selalu tiga pemeriksaan yang sama. Apakah ada og:image dengan URL absolut? Apakah og:title sudah diatur, atau platform memakai <title> generik sebagai cadangan? Apakah preview sudah ter-cache sebelum kamu menambahkan tag? Solusinya: tambahkan tag, lalu paksa scrape ulang. Kontennya tidak berubah; halamannya hanya mulai memperkenalkan dirinya.

FIG. 06Use Case: Dua URL, Satu Halaman

Kamu men-deploy blog dan baru sadar artikel yang sama bisa diakses di /articles/post, /articles/post/, dan /articles/post?utm_source=newsletter. Search engine melihat tiga kandidat dan harus memilih, sementara sinyal peringkat seperti tautan masuk terbagi di antara ketiganya.

Canonical per halaman (alternates.canonical di generateMetadata) mengarahkan ketiganya ke satu alamat. Bersama sitemap yang hanya memuat URL canonical, kamu sudah memberi tahu setiap crawler dengan jelas versi mana yang dihitung.

FIG. 07Checklist Audit Cepat

Jalankan daftar ini pada halaman mana pun sebelum dirilis:

PemeriksaanMengapa penting
<title> unik per halamanJudul hasil pencarian dan label tab
Meta description, ~150 karakterCuplikan yang mengundang klik
Canonical diatur per halaman, bukan di layoutMencegah dilusi akibat URL duplikat
og:image absolut, ~1200×630Preview tautan yang andal
robots.txt tidak memblokir halaman yang ingin kamu noindexCrawling vs. pengindeksan
Sitemap hanya memuat URL canonicalPenemuan yang lebih cepat dan bersih
JSON-LD validPeluang mendapat rich result
Preview di-scrape ulang setelah perubahanPlatform menyimpan cache dengan agresif
→ 02

Metadata adalah pekerjaan termurah dalam pengembangan web dengan dampak terpanjang. Kamu menulisnya sekali, dan setiap crawler, platform, serta hasil pencarian membacanya selamanya.

FIG. 08Bacaan Lanjutan

Semua sumber di bawah berbahasa Inggris.