Open Graph Nedir? Paylaşım Önizlemesi Ayarı
Yapay zeka destekli taslak; yayından önce baştan sona okunur ve iddialar birincil kaynaklara karşı kontrol edilir. İçerik üretim sürecimiz

Open Graph, bir web sayfasının bağlantısı Facebook, LinkedIn ya da protokolü okuyan başka bir platformda paylaşıldığında görünecek başlığı, açıklamayı, görseli ve adresi belirleyen bir etiket protokolüdür; sayfanın <head> bölümüne og:title, og:type, og:image ve og:url gibi <meta property="og:..."> satırları olarak yazılır. Bu etiketler yoksa platform sayfadan kendi tahminini çıkarır ve paylaşım önizlemesinde yanlış görsel, kesik başlık ya da boş bir kutu görülebilir. Önizleme siz düzelttikten sonra da eski kalıyorsa olası bir sebep platformun önbelleğidir; Meta'nın Sharing Debugger aracı ve LinkedIn'in Post Inspector aracı bağlantıyı yeniden okutmak için vardır.
Open Graph paylaşım görünümü için kurulur. Google'ın belgelerinde og:title başlık bağlantısının, og:site_name ise site adının oluşturulurken bakılan kaynakları arasında geçiyor; bu bir görünüm ayrıntısıdır, sıralamayla ilgili bir hüküm değildir ve aşağıda da öyle ele alınıyor.
Open Graph nedir? Protokolün dört zorunlu etiketi
Open Graph protokolü, herhangi bir web sayfasının bir sosyal grafikte "zengin bir nesne" gibi temsil edilmesini sağlamak için tanımlanmıştır; protokolün kendi metnine göre ilk olarak Facebook'ta oluşturulmuş, Dublin Core, link rel="canonical", Microformats ve RDFa'dan esinlenmiştir. Protokol, her sayfa için dört etiketi zorunlu sayar:
| Etiket | Ne taşır | Hizmet sayfası için örnek değer |
|---|---|---|
og:title | Nesnenin paylaşımda görünecek başlığı | Ölçüye Özel Mutfak Dolabı |
og:type | Nesnenin türü | website |
og:image | Nesneyi temsil eden görselin adresi | https://ornek.com/gorseller/mutfak-paylasim.jpg |
og:url | Nesnenin kalıcı kimliği olarak kullanılacak standart adres | https://ornek.com/hizmetler/mutfak-dolabi |
Bir hizmet sayfasının <head> bölümünde bu dört etiket ve iki isteğe bağlı etiket şöyle görünür:
<meta property="og:title" content="Ölçüye Özel Mutfak Dolabı" />
<meta property="og:type" content="website" />
<meta property="og:url" content="https://ornek.com/hizmetler/mutfak-dolabi" />
<meta property="og:image" content="https://ornek.com/gorseller/mutfak-paylasim.jpg" />
<meta property="og:image:alt" content="Beyaz lake kapaklı, ahşap tezgahlı bir mutfak dolabı" />
<meta property="og:description" content="Ölçü, malzeme seçimi ve montaj süreci tek sayfada." />
Etiketlerin name değil property özniteliğiyle yazıldığına dikkat edin; protokol RDFa'ya dayandığı için örneklerin tamamı property kullanır. ornek.com ve görsel adı yer tutucudur.
İsteğe bağlı etiketler: açıklama, site adı, dil ve görsel alt metni
Protokol, dört zorunlu etiketin yanında her nesne için isteğe bağlı ama "genel olarak önerilen" etiketler sayar. İşletme sitelerinde işe yarayanlar şunlardır:
| Etiket | Ne işe yarar | Not |
|---|---|---|
og:description | Paylaşımda başlığın altında çıkan kısa açıklama | Protokol bir iki cümle diyor |
og:site_name | Sayfa daha büyük bir sitenin parçasıysa sitenin adı | Marka adı burada durur |
og:locale | Etiketlerin yazıldığı dil ve bölge | Biçim dil_BÖLGE; varsayılan en_US, Türkçe için tr_TR |
og:locale:alternate | Sayfanın mevcut olduğu diğer diller | Çok dilli sitelerde |
og:image:width, og:image:height | Görselin piksel cinsinden genişliği ve yüksekliği | Platformun görseli işlemeden önce boyutu bilmesini sağlar |
og:image:alt | Görselde ne olduğunun tarifi | Protokol, og:image belirten sayfanın og:image:alt da belirtmesi gerektiğini yazar |
og:locale için varsayılanın en_US olması, Türkçe bir sitede bu etiketin neden yazılması gerektiğini de açıklar: etiket hiç yoksa, protokolü okuyan platform içeriği İngilizce varsayabilir.
Görsel alt metni, sayfadaki <img> alt metniyle aynı ilkeyle yazılır: görselde gerçekten görülen şey tarif edilir, slogan ya da anahtar kelime listesi yazılmaz. Protokol bunu açıkça "altyazı değil" diye ayırır.
Bir etiket birden fazla kez yazılabilir; protokole göre çakışma durumunda yukarıdan aşağıya ilk etiket tercih edilir. Birden çok görsel verilecekse her og:image satırının boyut bilgisi kendi kök etiketinden hemen sonra yazılır.
og:type website mı, article mı?
Protokol, işaretlenmemiş her web sayfasının og:type değeri website sayılması gerektiğini yazar. Meta'nın web yöneticileri için paylaşım rehberi de aynı varsayılanı söyler ve her adresin tek bir nesne olması gerektiğini, bu yüzden bir sayfada birden fazla og:type değerinin mümkün olmadığını ekler.
Blog yazıları ve haberler için protokolde ayrı bir article türü vardır. Bu tür, kendi ad alanında şu alanları taşıyabilir:
article:published_time— yazının ilk yayımlandığı zamanarticle:modified_time— yazının son değiştiği zamanarticle:author— yazar profiliarticle:section— bölüm adıarticle:tag— yazıyla ilişkili etiketler
Pratik ayrım basittir: ana sayfa, hizmet sayfaları, iletişim ve hakkımızda website; blog yazıları article. Yazının tarihleri, sayfada görünen yayın ve güncelleme tarihleriyle aynı olmalıdır. Sayfada "güncellendi" tarihi görünmüyorsa article:modified_time alanına sayfada karşılığı olmayan bir tarih yazmak, yapılandırılmış veride görünmeyen bilgi bildirmekle aynı sorunu yaratır.
Open Graph ile title etiketi ve meta açıklaması arasındaki fark
Bir sayfada başlık bilgisi üç yerde durabilir: <title> etiketi, sayfadaki <h1> başlığı ve og:title. Üçü farklı yerlerde görünür ve farklı biçimde yazılabilir.
| Alan | Nerede görünür | Yazım ilkesi |
|---|---|---|
<title> | Tarayıcı sekmesi; Google'ın başlık bağlantısı için ana kaynaklardan biri | Sayfanın konusu, gerekiyorsa marka adıyla |
<h1> | Sayfanın kendisi | Ziyaretçinin sayfaya girdiğinde okuduğu başlık |
og:title | Paylaşım önizlemesi | Meta'nın rehberine göre site adı gibi marka eklemesi olmadan başlığın kendisi |
Meta'nın rehberi og:description için de iki ile dört cümle arası kısa bir açıklama önerir. Arama sonucundaki açıklamayla paylaşım açıklamasının aynı olması zorunlu değildir. Arama sonucunda açıklamanın nasıl seçildiğini ve uzunluğun neyi değiştirdiğini Google'ın kendi belgeleri belirler; bu kurallar title etiketi ile meta açıklamasının yazımı için bir araya getirilmiş durumda.
Google tarafında tek bir bağ var: Google'ın başlık bağlantıları belgesi, başlık bağlantısını otomatik belirlerken kullandığı kaynakları sayarken <title> öğesi, ana görsel başlık, <h1> gibi başlık öğeleri ve sayfadaki diğer metinlerin yanında og:title meta etiketlerindeki içerikleri de listeliyor. Site adları belgesi de og:site_name'i site adını belirlerken dikkate alınan içerikler arasında sayıyor, ama tercih belirtmek için en önemli yolun ana sayfadaki WebSite yapılandırılmış verisi olduğunu yazıyor. Bu iki belge og: etiketlerinin Google'da başlık ve site adı görünümüne girdi olabileceğini söylüyor; sıralama hakkında bir şey söylemiyor.
og:image boyutu: Meta ve LinkedIn ne istiyor?
Paylaşım önizlemesinin en göze çarpan kısmı görseldir ve iki büyük platform ölçüyü farklı belgelerde yazıyor. Meta'nın bağlantı paylaşımlarındaki görseller belgesine ve LinkedIn yardım merkezindeki "web sitenizi LinkedIn'de paylaşılabilir yapın" maddesine göre ölçüler şöyle:
| Ölçüt | Meta (Facebook) | LinkedIn paylaşım modülü |
|---|---|---|
| En küçük boyut | 200 x 200 piksel | 1200 x 627 piksel |
| Önerilen boyut | Yüksek çözünürlüklü ekranlar için en az 1200 x 630 piksel | Belgede ayrıca yazmıyor |
| Büyük görselli gönderi için alt sınır | 600 x 315 piksel; daha küçükse görsel çok daha küçük gösterilir | Belgede ayrıca yazmıyor |
| En-boy oranı | 1,91:1'e olabildiğince yakın | Önerilen oran 1,91:1 |
| Dosya boyutu sınırı | 8 MB | 5 MB |
İki tablo birlikte okunduğunda 1200 x 630 piksel ve 5 MB'ın altında bir görsel her iki platformun yazılı şartını karşılar. Görselin içine yazı konacaksa önemli kısmın kenarlarda değil ortada durması, kırpma ihtimaline karşı güvenli bir alışkanlıktır; platformların kırpma davranışı okunan belgelerde piksel olarak tarif edilmiyor.
Paylaşım görseli ile site simgesi aynı şey değildir. Tarayıcı sekmesinde ve arama sonucunda görünen küçük kare işaret ayrı dosyalar ve ayrı etiketlerle tanımlanır; favicon boyutu ve biçimi kurallarının yerini og:image tutmaz, tersi de geçerlidir.
Etiketler nasıl eklenir? Sunucu, sistem ve sıkıştırma
Open Graph etiketlerinin yeri sayfanın <head> bölümüdür ve platformun tarayıcısı bu bölümü sunucudan gelen HTML'de görmelidir. Üç ayrıntı burada belirleyicidir.
Etiket sunucudan gelen HTML'de mi? Paylaşım tarayıcıları sayfayı bir insan gibi açıp betikleri çalıştırmayabilir. Etiketler yalnızca JavaScript çalıştıktan sonra ekleniyorsa, önizleme boş gelebilir. Meta'nın rehberi bunun için bir test tarif ediyor: tarayıcının kullanıcı aracısını facebookexternalhit/1.1 (+http://www.facebook.com/externalhit_uatext.php) olarak değiştirip sayfayı açmak, sonra bir mobil tarayıcı kimliğiyle tekrar açmak. Sayfa ikincisinde doğru yükleniyor ama birincisinde yüklenmiyorsa sorun kullanıcı aracısının ele alınışındadır.
og:url standart adres mi? Meta'nın rehberi og:url için sayfanın standart adresini, oturum değişkeni, kullanıcıyı tanımlayan parametre ya da sayaç içermeyen yalın hâlini istiyor; beğeni ve paylaşımlar bu adreste toplanır. Bu, sayfadaki rel="canonical" ile aynı adres olmalıdır. Aynı içerik birden fazla adresten açılıyorsa hangisinin standart sayılacağı kopya içerik ve canonical üzerinden önce netleşir, og:url ona uyar.
Sunucunun sıkıştırma biçimi uyumlu mu? Meta'nın görsel belgesi, tarayıcısının yalnızca gzip ve deflate kodlamalarını kabul ettiğini yazıyor. Sunucunuz yanıtı yalnızca başka bir biçimde sıkıştırıyorsa önizleme sorunlu çıkabilir; hangi biçimin gönderildiği tek bir komutla görülebilir. Komutu çalıştırmadan önce gzip ile Brotli farkını bilmek, yanıttaki content-encoding satırını okumayı kolaylaştırır.
Etiketlerin nasıl yazılacağı kullandığınız sisteme bağlıdır. İçerik yönetim sistemlerinde SEO eklentisinin ya da temanın ayarlarında "sosyal" veya "paylaşım" bölümü olup olmadığına bakılır; hazır site kurucularında aynı ayar sayfa ayarlarının içinde bulunabilir; elle yazılmış sitelerde etiketler şablonun <head> kısmına sayfa başına değişen değerlerle eklenir. Hangi yol seçilirse seçilsin, kontrol yayındaki sayfanın kaynak kodunda yapılır: og: satırları orada görünmüyorsa platform da görmez.
Paylaşım önizlemesi neden yanlış ya da boş görünür?
Önizleme sorunlarının nedenleri belli başlı birkaç gruba ayrılır. Hangisinin geçerli olduğu, aşağıdaki tablonun sağ sütunundaki kontrolle ayrılır.
| Belirti | Olası neden | Kontrol |
|---|---|---|
| Etiketi düzelttiniz ama eski görsel ve başlık görünüyor | Platform bağlantıyı önceki paylaşımdan önbelleğe almış | Hata ayıklama aracında yeniden okutmak |
| İlk paylaşımda görsel yok, sonrakilerde var | Meta'nın belgesine göre tarayıcı görseli en az bir kez görmeden işleyemez | Görseli önceden okutmak ya da og:image:width ve og:image:height eklemek |
| Görseli değiştirdiniz, adres aynı kaldı | Meta görselleri adresine göre önbelleğe alıyor | Yeni görsele yeni dosya adı vermek, eskisini silmemek |
| Görsel küçük kutu olarak çıkıyor | Görsel platformun büyük görsel eşiğinin altında | Boyutu tablodaki değerlere çıkarmak |
| Hiç önizleme yok | Etiket sunucu HTML'inde yok ya da sunucu platform tarayıcısını engelliyor | Kaynak kodu ve kullanıcı aracısı testi |
| Görsel çıkmıyor ama etiket doğru | Görsel korumalı bir dizinde ya da erişime kapalı | Görsel adresini tarayıcıda oturumsuz açmak |
Son satırın LinkedIn tarafında da karşılığı var: LinkedIn'in paylaşım maddesi, görsel şartları karşıladığı hâlde güncellemelerde görünmüyorsa sitenin LinkedIn'in görseli çekmesini engelliyor olabileceğini ya da görselin korumalı bir dizinde bulunabileceğini yazıyor.
Meta'nın görsel belgesi bir ayrıntının altını ayrıca çiziyor: bir adresin görselini güncellemek, o adresin eski paylaşımlarındaki önizlemeyi kendiliğinden değiştirmez. Önceden yapılmış paylaşımlar ayrıca yenilenmedikçe eski görselle kalır.
Meta Sharing Debugger ve LinkedIn Post Inspector ile kontrol
İki platformun da bağlantıyı yeniden okutan bir aracı var ve ikisi de aynı işi biraz farklı sınırlarla yapıyor.
Meta Sharing Debugger. Meta'nın rehberine göre araç, girilen adres için Facebook tarayıcısının hangi meta etiketlerini okuduğunu, hata ve uyarıları gösterir ve sayfanın yeniden okunmasını tetikler; böylece HTML'deki bir hata düzeltildikten sonra içerik güncellenebilir. Görsel belgesi aynı aracı görseli önceden önbelleğe almanın yollarından biri olarak sayar. Aracın kendi ekranı kullanmak için Facebook'a giriş yapılması gerektiğini yazıyor.
LinkedIn Post Inspector. LinkedIn'in Post Inspector ile adres yenileme maddesi aracın amacını şöyle tarif ediyor: bir adresi daha önce paylaştıysanız görsel önbellekte saklanmış olabilir ve yeni gönderide eski görsel görünür. Araçla adres girilir ve önizleme penceresinin doğru içeriği gösterdiği doğrulanır. Madde bir sınırı da yazıyor: yapılan değişiklikler yalnızca o adresi içeren yeni gönderilerin önizlemesini etkiler, mevcut gönderilerin önizlemesi aynı kalır.
Kontrol sırası şöyle kurulabilir:
- Yayındaki sayfanın kaynak kodunda
og:satırlarını görün. - Adresi Sharing Debugger'a girip okunan etiketleri ve uyarıları kontrol edin.
- Aynı adresi Post Inspector'a girip LinkedIn önizlemesini kontrol edin.
- Görsel değiştiyse yeni dosya adının önizlemede göründüğünü doğrulayın.
- Sayfayı ilk kez paylaşmadan önce bu kontrolü yapın; Meta'nın belgesine göre görseli henüz görmemiş bir tarayıcı, ilk paylaşımda görseli işleyemeyebilir.
Gönderileri Meta'nın yönetim panelinden planlıyorsanız, bağlantılı bir gönderi oluşturulurken görünen önizleme de bu etiketlerden beslenir; Meta Business Suite'te gönderi planlama aşamasında önizlemede yanlış görsel görülüyorsa sorun gönderide değil sayfanın etiketlerindedir. WhatsApp, Telegram, X ya da mesajlaşma uygulamalarının önizleme davranışı okunan belgelerin kapsamında değil; bu uygulamalarda görünümü kendi denemenizle kontrol etmek gerekir.
Hangi sayfalara özel Open Graph yazılır?
Her sayfaya aynı başlık ve aynı görseli veren bir şablon, paylaşılan her bağlantının aynı göründüğü bir sonuç verir. Sayfa türüne göre ayrım şöyle yapılabilir:
| Sayfa türü | og:type | Görsel seçimi | Not |
|---|---|---|---|
| Ana sayfa | website | Marka görseli ya da işletmenin kendisi | og:site_name burada da yazılır |
| Hizmet sayfası | website | Hizmetin gerçek bir fotoğrafı | Başlık hizmetin adı, marka eki olmadan |
| Blog yazısı | article | Yazının kapak görseli | Yayın ve güncelleme tarihi sayfadakiyle aynı |
| Hakkımızda | website | Ekip, atölye ya da işletme cephesi | Görselde görünen alt metne yazılır |
| İletişim | website | Ana sayfa görseli yeterli | Adres ya da harita görseli de olabilir |
Hakkımızda gibi kimlik taşıyan sayfalarda paylaşım görseli, sayfanın kendisinde kullanılan gerçek fotoğraflardan seçilirse önizleme ile sayfa birbiriyle tutarlı olur; o sayfada hangi blokların yer aldığını hakkımızda için yedi bloklu yapı belirler, paylaşım görseli yalnızca bunlardan birini öne çıkarır.
Open Graph, ziyaretçinin sizi sosyal medyada bulmasıyla ilgili değildir; başkası sayfanızı paylaştığında nasıl görüneceğini belirler. Sosyal profillerinize verilen bağlantıların yeri ise sitenin her sayfasında tekrar eden alt bölgedir; footer'a konacak bağlantıların listesi iletişim, yasal metin ve hizmet bağlantılarıyla birlikte o bölgede planlanır.
Kurumsal bir sitede bu ayrımın baştan yapılması, şablonun her sayfa türü için ayrı değer üretebilmesine bağlıdır. Kurumsal web sitesi kurulumunda "Yapılandırılmış veri ve teslim" kalemi, sayfada görünen bilginin makine okunur kopyasının görünen bilgiyle birebir aynı tutulmasını ve teslimde sitemap, robots ve analitik kurulumunu kapsar; Open Graph etiketleri o kalemde adıyla sayılmıyor, bu yüzden teslim listesine ayrıca yazdırılması istenebilir.
Yayın öncesi Open Graph kontrol listesi
Yeni bir sayfa yayına alınmadan önce aşağıdaki maddeler tek tek işaretlenir:
og:title,og:type,og:imageveog:urlyayındaki sayfanın kaynak kodunda görünüyor.og:url, sayfanınrel="canonical"adresiyle aynı.og:titlemarka eki olmadan sayfanın konusunu söylüyor;og:site_namemarka adını taşıyor.og:descriptionsayfada gerçekten anlatılan şeyi bir iki cümlede özetliyor.og:localedeğeritr_TR.- Görsel en az 1200 x 630 piksel, 1,91:1'e yakın ve 5 MB'ın altında.
og:image:width,og:image:heightveog:image:altyazılı; alt metin görselde görüneni tarif ediyor.- Görsel adresi oturum açmadan tarayıcıda açılıyor.
- Blog yazısında
article:published_timeve varsaarticle:modified_time, sayfada görünen tarihlerle aynı. - Adres Sharing Debugger ve Post Inspector'da okutuldu, iki önizleme de doğru.
Sıkça Sorulan Sorular
Open Graph nedir?
Open Graph, bir web sayfasının bağlantısı Facebook, LinkedIn gibi protokolü okuyan platformlarda paylaşıldığında görünecek başlığı, açıklamayı, görseli ve adresi belirleyen bir meta etiket protokolüdür. Etiketler sayfanın head bölümüne og:title, og:type, og:image ve og:url gibi satırlar olarak yazılır; protokol bu dördünü her sayfa için zorunlu sayar. Etiket yoksa platform sayfadan kendi tahminini çıkarır.
Open Graph etiketleri nasıl eklenir?
Etiketler sayfanın head bölümüne meta property satırları olarak eklenir. İçerik yönetim sistemlerinde bu iş SEO eklentisinin ya da temanın paylaşım ayarlarından, elle yazılmış sitelerde şablonun head kısmından yapılır. Etiketlerin sunucudan gelen HTML'de görünmesi gerekir; yalnızca JavaScript çalıştıktan sonra eklenen etiketleri paylaşım tarayıcıları görmeyebilir.
og:image boyutu kaç olmalı?
Meta'nın belgesi yüksek çözünürlüklü ekranlar için en az 1200 x 630 piksel, büyük görselli gönderi için en az 600 x 315 piksel, 1,91:1'e yakın oran ve en fazla 8 MB öneriyor. LinkedIn'in paylaşım şartları en az 1200 x 627 piksel, 1,91:1 oran ve en fazla 5 MB yazıyor. 1200 x 630 piksel ve 5 MB'ın altında bir görsel iki platformun yazılı şartını birlikte karşılar.
Paylaşımda eski görsel çıkıyorsa ne yapılmalı?
Platform bağlantıyı önceki paylaşımdan önbelleğe almış olabilir. Facebook için Meta Sharing Debugger, LinkedIn için Post Inspector adresi yeniden okutur. Meta görselleri adresine göre önbelleğe aldığı için yeni görsele yeni bir dosya adı vermek gerekir; iki platform da güncellemenin eski gönderilerin önizlemesini kendiliğinden değiştirmediğini yazıyor.
Open Graph ile meta açıklaması aynı şey mi?
Hayır. Meta açıklaması HTML'deki description etiketidir ve arama sonucunda açıklama olarak kullanılabilir; Open Graph açıklaması og:description etiketidir ve paylaşım önizlemesinde başlığın altında görünür. İkisi aynı metni taşıyabilir ama taşımak zorunda değildir. Google'ın başlık bağlantıları belgesi og:title etiketini başlık bağlantısının kaynaklarından biri olarak sayar; bu bir görünüm ayrıntısıdır.