Mengatur kartu preview saat link dibagikan, helper openGraphMetadata di mahir.dev, gambar Open Graph, dan opengraph-image.tsx.
12m bacaanKuis WajibMicro Badge Lesson
Open Graph dan Twitter Card
Saat link web kamu dibagikan di WhatsApp, Facebook, LinkedIn, X, atau Telegram, aplikasi itu mengambil halamannya dan membuat kartu preview berisi judul, deskripsi, dan gambar. Isi kartu itu diambil dari tag Open Graph (og:*) dan Twitter Card (twitter:*). Tanpa tag ini, aplikasi menebak sendiri, dan hasilnya sering berupa judul acak tanpa gambar.
Ini bukan sinyal ranking Google. Tapi untuk web yang banyak dibagikan di grup chat dan media sosial (seperti kampanye promosi mahir.dev), kartu preview menentukan apakah orang mau mengklik.
Lewat Metadata API
tsx
export const metadata: Metadata = { openGraph: { type: "website", locale: "id_ID", siteName: "Mahir.dev Academy", title: "Belajar Next.js Full Stack", description: "Bangun aplikasi web lengkap dengan Next.js, dari routing sampai deploy.", url: "/belajar/nextjs-full-stack", images: [{ url: "/og/nextjs.png", width: 1200, height: 630 }], }, twitter: { card: "summary_large_image", },};
Dengan metadataBase di root layout, URL relatif seperti /og/nextjs.png diubah menjadi URL absolut. URL absolut ini wajib, karena aplikasi chat mengambil gambar dari server mereka, bukan dari browser pengunjung.
twitter.card: "summary_large_image" membuat X menampilkan gambar besar. Kalau twitter.title atau twitter.description tidak diisi, X memakai nilai Open Graph.
Helper di mahir.dev
Mahir.dev mengumpulkan pola ini dalam satu fungsi di src/lib/seo.ts:
Setiap halaman cukup memanggil ...openGraphMetadata({ title, description, url }) di metadata-nya. Kalau halaman tidak punya gambar sendiri, gambar default dipakai, jadi tidak ada kartu tanpa gambar.
Ada satu hal yang perlu diperhatikan saat memakai helper seperti ini. Field openGraph di page menimpa seluruh objek openGraph dari layout, bukan menggabungkannya per field. Karena itu helper yang mengembalikan objek lengkap lebih aman daripada mengisi sebagian field di setiap page.
Gambar Open Graph
ukuran yang aman untuk hampir semua platform adalah 1200 × 630 piksel
teks penting ada di tengah, karena beberapa platform memotong sisi gambar
format PNG atau JPEG; tidak semua platform mendukung WebP atau AVIF untuk preview
ukuran file kecil. Beberapa aplikasi chat tidak menampilkan gambar kalau file-nya terlalu besar.
Gambar yang dibuat otomatis
Untuk halaman yang jumlahnya banyak (course, artikel, buku), membuat gambar satu per satu tidak praktis. Next.js mendukung file opengraph-image.tsx di folder route, yang membuat gambar dari JSX:
Next.js otomatis menambahkan tag og:image untuk route itu. ImageResponse hanya mendukung sebagian properti CSS (tata letak memakai flexbox), jadi desainnya perlu dibuat sederhana.
Pastikan og:image berisi URL absolut yang bisa dibuka langsung di browser.
Tempel link di aplikasi chat untuk melihat hasilnya. Beberapa platform menyimpan preview lama di cache. Facebook dan LinkedIn punya alat debugger untuk meminta preview diambil ulang.
Penutup modul
Kamu sekarang bisa memastikan setiap halaman punya title, description, dan canonical yang benar, halaman private tidak masuk index, sitemap dan robots.txt sinkron dengan data, dan link tampil rapi saat dibagikan. Modul berikutnya membahas structured data: cara memberi tahu Google jenis isi halamanmu.
Checkpoint KuisTarget: 70%
Kuis: Open Graph dan Twitter Card
Kuis ini wajib untuk sertifikat. Kamu tetap bisa lanjut ke pelajaran berikutnya dan mengerjakannya nanti.