Not: Bu yazıdaki testler ve ekran görüntüleri 2026 Ağustos tarihlidir.
X akışı sitede neden görünmüyor: 7 olası neden
Türkçe arama sonuçlarında hâlâ üst sıralarda duran rehberlerin bir bölümü, Twitter döneminden kalma bir ayar ekranını ve orada üretilen bir bileşen kodunu anlatıyor. Bugün tek resmi araç publish.x.com ve aşağıdaki testte tam olarak ne verdiğini göreceksiniz. “Twitter gömme kodu çalışmıyor” aramalarının bitmemesinin somut nedenleri var; bunları yedi başlıkta toplayabiliriz. Önce hangisinin sizin durumunuza uyduğuna bakın:
- Hâlâ twitter.com adresli bir kod kullanıyorsunuz. 2023'teki X yeniden markalaşmasıyla adresler x.com'a taşındı; eski ya da önbelleğe alınmış gömme kodları kırık kaldı.
- widget.js yüklenmiyor. Gömme kodunu zaman akışına dönüştüren resmi betik, içerik yönetim sisteminiz ya da modern ön uç çatılarıyla çakışıp sık sık yüklenemiyor.
- Oturum açmamış ziyaretçilere yönelik kısıtlamalar. 2023'ten bu yana X, oturum açmadan okumayı kademeli olarak kısıtladı; pek çok ziyaretçi gömmenin olduğu yerde yalnızca boşluk görüyor.
- Zaman akışı gömmesinin kendisi bozuk. Bugünkü publish.x.com, bir profil girdiğinizde yalnızca “Posts by [hesabınız]” yazan bir metin bağlantısı üretiyor (aşağıdaki test bölümünde gerçek ekranı göreceksiniz).
- X API'si ücretli hâle geldi. API v2 geçişiyle ücretsiz kullanım büyük ölçüde kısıldı ve akışları ücretsiz çeken pek çok dış servis kapandı.
- Hesap gizliye alındı. Gömdüğünüz hesap korumalı gönderilere geçerse gömme, hiçbir hata mesajı vermeden boş bir alana dönüşüyor.
- Yalnızca düzenleme ekranında görünen kısıtlamalar. Squarespace düzenleme görünümünde betikleri devre dışı bırakıyor, Webflow'un Designer'ı ise gömmeleri hiç işlemiyor. İkisinde de yayımlanmış sayfa düzgün görünüyor. En sık yaşanan yanlış alarm bu.
Animasyonda ne var
Animasyon aynı web sayfası bölümünü yan yana iki durumda gösteriyor: solda sosyal içerik olmayan sade hâli, sağda birden fazla platformun gönderi kartları, Google yıldızları ve beğeni sayaçlarıyla canlanan bir sosyal duvar. Sağdaki durum, çalışan bir gömmenin ürettiği sonuçtur; kırık resmi gömme ise tam olarak orayı boş bırakır.
Resmi araç publish.x.com ile yaptığım test
publish.x.com'u açtığınızda “What would you like to embed?” sorusu sizi karşılıyor ve dört giriş kabul ediliyor: bir gönderi adresi, bir profil adresi, bir kullanıcı adı (@kullaniciadi) ve bir hashtag. Dördünü de denedim. Sonuçlar şöyle:
Tek gönderi: bu çalışıyor
SpaceX'in bir gönderi adresini girdiğimde iki görüntüleme biçimi sunuldu: “Embedded Video” ve “Embedded Post”. Önizlemede metin, görsel, tarih ve etkileşim sayılarıyla birlikte düzgün bir kart göründü. Kodu siteme yapıştırdığımda gönderi olması gerektiği gibi göründü. Tek bir gönderiyi bir yazının içine almak istiyorsanız resmi araç yeterli.
Profil adresi (zaman akışı): kırık
Sırada profil vardı. https://x.com/SpaceX girip “Embedded Timeline” seçeneğini işaretledim. Önizlemede akış yerine yalnızca “Posts by SpaceX” yazısı çıktı. Asıl sorun ise üretilen kodun içindeki adres: https://s.com/SpaceX. x.com bile değil, var olmayan bir adres. Kodu yine de siteme yapıştırdım, sonuç aynıydı. Zaman akışı yok, yalnızca kırık bir bağlantı var.
Kullanıcı adı (@XDevelopers): aynı sonuç
X'in örnek olarak kendi önerdiği @XDevelopers kullanıcı adıyla da denedim; sonuç değişmedi. Yine “Posts by XDevelopers” metni ve yine https://s.com/XDevelopers adresine giden kırık bir bağlantı üretildi.
Hashtag (#WhatsHappening): seçenek hiç yok
#WhatsHappening girdiğimde bu kez “Embedded Timeline” seçeneği hiç çıkmadı. Üretilen tek şey “Post #WhatsHappening” yazan bir paylaşım butonuydu; yani insanları o etiketle gönderi atmaya yönlendiren bir düğme. Kısacası resmi araçlarla bir hashtag akışını siteye gömmenin yolu yok. Etkinlik ya da kampanya için hashtag duvarı kuracaksanız resmi aracı baştan listeden çıkarabilirsiniz.
Çalışan yöntem: X akışını CollectSocials ile web sitesine ekleme
Resmi aracı bir kenara bıraktıktan sonra CollectSocials ile devam ettim ve o gün bugündür bunu kullanıyorum. API anahtarı üretmeniz, geliştirici hesabı açmanız ya da widget.js'te hata ayıklamanız gerekmiyor. Süreç altı adımdan oluşuyor:
- CollectSocials'a kaydolun ve Organize panelinden yeni bir akış oluşturun
- “Add Source” düğmesine basıp platform listesinden X/Twitter'ı seçin
- İçe aktarma yöntemini seçin: “My Tweets” (kendi zaman akışınız) ya da “Hashtag” (etiket toplama). My Tweets için OAuth 2.0 ile hesap bağlanır, hashtag için hesap bağlantısı gerekmez
- Collect ekranında gönderileri yönetin: sabitleyin, çıkarın, anahtar kelimeyle süzün
- Design Studio'da düzeni ve tasarımı belirleyin
- “Get Code” ile gömme kodunu alın ve sitenize yapıştırın
sync
Kartlar siteye nasıl geçiyor
Solda kilitli bir X kutusu ve içinde bekleyen gönderi kartları, ortada “auto sync” yazan bir aktarım hattı, sağda ise tarayıcı penceresindeki X akışı widget'ı var. Kartlar tek tek karşıya geçip widget'taki boş kutuları doldururken sayaç ilerliyor ve akış canlı duruma geçiyor. Anlatılan şey basit: bir kez kurduktan sonra yeni gönderiler siteye elle kopyalanmadan düşüyor.
1. adım: yeni akış oluşturma
Kaydolduğunuzda Organize paneli açılıyor. “Create New Feed” kutusuna tıklayın. Birden fazla akış oluşturabilirsiniz; örneğin biri kurumsal zaman akışı, diğeri kampanya hashtag'i için.
2. adım: kaynak olarak X/Twitter seçme
“Add Source” düğmesi platform seçim ekranını açıyor. Buradan X/Twitter kartını seçin. YouTube, Google yorumları, TikTok, Facebook, Instagram, Pinterest, Tumblr, RSS ve Vimeo gibi kaynaklar da destekleniyor ve bunları tek bir widget içinde ortak bir sosyal duvar olarak birleştirebilirsiniz. Facebook sayfası eklemeyi anlatan ayrıntılı rehberimiz İngilizce olarak burada.
3. adım: içe aktarma yöntemini seçme
Bu ekranda önce ne aktaracağınızı seçiyorsunuz: “My Tweets” (kendi zaman akışınızı aktarma) ya da “Hashtag” (herkese açık etiket gönderilerini toplama). “My Tweets” seçtiyseniz “Connect X” düğmesiyle OAuth 2.0 üzerinden yetki veriyorsunuz: parolanız CollectSocials'ta saklanmaz ve bağlantıyı istediğiniz an X ayarlarından iptal edebilirsiniz. Hashtag toplama, resmi araçta hiç bulunmayan bir özellik; üstelik bunun için hesap bağlamanız da gerekmiyor.
4. adım: gönderileri yönetme
Kurulum bittiğinde gönderiler Collect ekranına düşüyor. Gömülü bir akışı temiz tutmanın püf noktası burası: öne çıkarmak istediğiniz gönderiyi sabitliyor, sitenize yakışmayanı akıştan çıkarıyor, anahtar kelime filtreleriyle de baştan eliyorsunuz. Kontrol gönderi düzeyinde sizde kalıyor.
5. adım: Design Studio'da tasarımı belirleme
Design Studio'da Carousel, List, Masonry ya da Timeline gibi düzenler arasından birini seçip renkleri, yazı tiplerini ve kart stilini sitenize uyduruyorsunuz. X görselden çok metne dayalı bir platform olduğu için, yazının rahat okunduğu Timeline ve List düzenleri genelde en iyi sonucu veriyor.
6. adım: önizlemeyi kontrol edip gömme kodunu alma
“Preview” ile masaüstü, tablet ve mobil görünümleri kontrol edin; her şey yolundaysa “Get Code” ile gömme kodunu alın. Geriye kodu sitenize yapıştırmak kalıyor. Platform bazında ayrıntılı adımlar bir sonraki bölümde.
Kurulum adım adım
Animasyon widget kurulumunu baştan sona altı adımda sıralıyor: hedefi belirleme, akış türünü seçme, hesabı bağlama, gönderi denetimini ayarlama, düzeni özelleştirme ve kodu gömüp mobilde test etme. Adımlar sırayla belirirken her birinin numarası yeşil bir onay işaretine dönüşüyor.
X bağlantısının maliyeti
Bilmeniz gereken bir nokta var: X artık API'si için ücret alıyor. Hem hesap bağlantısı hem de çekilen her gönderi maliyet doğuruyor. Bu yüzden bu tür servislerin neredeyse tamamında X bağlantısı ücretli paket özelliği durumunda. CollectSocials'ta da öyle. Buna karşılık ücretsiz deneme süresinde hem zaman akışını hem de hashtag toplamayı, sınırlı bir gönderi çekme kotasıyla deneyebiliyorsunuz. Yani ödeme kararını vermeden önce akışın kendi sitenizde nasıl göründüğünü görüyorsunuz. Küçük bir ayrıntı: deneme kotası gün gün birikiyor, bu nedenle aynı anda birkaç X kaynağını birden denerseniz ilk hashtag çekimi ertesi güne kayabilir. Paket ayrıntıları için fiyatlandırma sayfasına (İngilizce) bakabilirsiniz.
Akış bundan sonra düzenli aralıklarla kendiliğinden eşitleniyor, elle güncelleme yapmanız gerekmiyor. Ancak bunun bir gerçek zamanlı yayın olmadığını baştan bilmek iyi olur. Akış ayarlarındaki ön onay (Pre-approve) seçeneğini açtığınızda, çekilmiş gönderilerin ne zaman yayına gireceğine siz karar verirsiniz; fakat bu seçenek X kaynağının eşitleme aralığını kısaltmaz. Bu yüzden etkinlik alanında çalışan bir hashtag duvarında, etkinlik sırasında atılan bir gönderi duvara ancak bir sonraki eşitlemeden sonra düşer.
Video anlatım (İngilizce)
Ses İngilizce, ancak ekranda bu yazıdaki adımların aynısı gösteriliyor; sesi açmadan da takip edebilirsiniz.
Resmi gömme ile CollectSocials karşılaştırması
| Ölçüt | Resmi gömme (publish.x.com) | CollectSocials |
|---|---|---|
| Ücret | Ücretsiz | Ücretli paket (fiyatlandırma, İngilizce), ücretsiz deneme dâhil |
| Tek gönderi gömme | Var, sorunsuz çalışıyor | Var |
| Profil zaman akışı | Yok, yalnızca metin bağlantısı üretiyor | Var, kendiliğinden güncellenen akış |
| Hashtag akışı | Yok, özellik olarak bulunmuyor | Var; toplama, denetim ve gömme birlikte |
| Düzen seçenekleri | Yalnızca temel zaman akışı görünümü | Carousel, List, Masonry, Timeline ve daha fazlası |
| Özelleştirme | Yükseklik, genişlik, açık/koyu | Renk, yazı tipi, tema ve kart stili |
| Gönderi denetimi | Yok | Sabitleme, çıkarma, anahtar kelime filtresi, ön onay |
| Otomatik güncelleme | Güvenilmez | Düzenli aralıklarla eşitleme, elle işlem gerekmez |
| Mobil uyum | Sık sık bozuluyor | Duyarlı tasarım ve cihaz bazında önizleme |
| Birden fazla platform | Yalnızca X | X, YouTube, Google yorumları, TikTok, Facebook ve diğerleri |
| CSS yalıtımı (Shadow DOM) | Yok, sitenizin CSS'iyle çakışabilir | Var, sitenizin stilleriyle karışmaz |
Platform bazında ekleme: WordPress, Shopify, Webflow ve diğerleri
Gömme kodunu aldıktan sonra yapmanız gereken tek şey, kullandığınız sistemin kurallarına göre kodu yerleştirmek. CollectSocials kod alma ekranında platformu seçtiğinizde o platforma uygun biçimi veriyor: betik çalıştırmayan servisler için iframe, Shopify için ise temanın widget'ı ezmesini önleyen sarmalayıcılı bir kod.
WordPress (Gutenberg editörü)
- Akışı göstereceğiniz sayfayı veya yazıyı açın
- “+” ile blok ekleyin ve “Özel HTML” bloğunu aratın
- Gömme kodunu Özel HTML bloğunun içine yapıştırın
- Blok araç çubuğundaki önizlemeyle kontrol edip yayımlayın
Bu yol için ayrıca bir eklenti kurmanız gerekmiyor. Yine de CollectSocials bir WordPress eklentisi (İngilizce) yayımlıyor ve gerçekten trafik alan bir sayfada eklenti daha avantajlı: gönderileri ve yayımlanmış tasarımı kendi WordPress veritabanınıza kopyalayıp sizin alan adınızdan sunuyor, dolayısıyla ilk eşitleme tamamlandıktan sonra o sayfanın görüntülenmeleri paketinizin sayacına işlemiyor; ücretsiz pakette de öyle. İlk eşitlemeden önce ya da akış kaydedilemediğinde eskisi gibi barındırılan gömme gösteriliyor.
Shopify (Online Store 2.0)
- Shopify yönetim panelinde “Online Store > Themes > Customize” yolunu izleyin
- Akışı ekleyeceğiniz sayfada “Add section” düğmesine basın
- “Custom Liquid” bölümünü seçip kodu Liquid alanına yapıştırın
- Bölümü istediğiniz yere taşıyıp kaydedin
Shopify için üretilen kod, temanın flexbox düzeninin widget'ı ezmemesi adına sayfa genişliğinde bir kapsayıcıyla sarmalanıyor. Kod alma ekranında Shopify'ı seçmeniz yeterli, bu fark kendiliğinden uygulanıyor.
Webflow
- Projenizi Webflow Designer'da açın
- Components altındaki Embed öğesini akışın duracağı yere sürükleyin
- Kodu kod alanına yapıştırıp düzenleyiciyi kapatın
- Siteyi yayımlayıp sonucu kontrol edin
Önemli: Webflow Designer'ın içinde gömme işlenmez. Bu bir arıza değil; içerik ancak yayımlanmış sayfada görünür.
Wix, Squarespace ve diğer servisler
Wix ve Squarespace dışarıdan gelen <script> etiketlerini kısıtlıyor. Bu iki servis için CollectSocials iframe biçiminde bir gömme kodu üretiyor. Wix'te kodu bir HTML gömme öğesine, Squarespace'te ise bir kod bloğuna yapıştırmanız yeterli. Bu iki biçimde iframe yüksekliği akışın içeriğine göre kendiliğinden ayarlanıyor.
Squarespace'te “görünmüyor” diyorsanız: Squarespace düzenleme görünümünde betikleri devre dışı bırakır, bu yüzden siz sayfayı düzenlerken alan bozuk görünebilir ya da akış yerine bir uyarı çıkabilir. Bu davranış yalnızca düzenleme ekranına özeldir; yayımlanmış sayfa düzgün görünür. Yayımlamadan önce gömmeyi bozuk ilan etmeyin.
Betik çalıştırmayan servisler için, yalnızca bir adres verdiğiniz sabit yükseklikli bir iframe biçimi de var. Özel HTML yazabildiğiniz her yerde (statik HTML siteler ve benzerleri) ise standart kod olduğu gibi çalışıyor.
X hashtag akışını web sitesine ekleme
Test bölümünde gördüğünüz gibi resmi araç hashtag akışı gömmeyi desteklemiyor; ürettiği tek şey bir paylaşım butonu. X API'sinde etiket araması var, ancak bunu kendiniz kurmak geliştirici zamanı ve API maliyeti demek. Üçüncü taraf araçların çözdüğü sorun tam olarak bu: API tarafını üstlenip size gömülmeye hazır bir widget veriyorlar.
CollectSocials tarafında adımlar zaman akışı kurulumuyla neredeyse aynı. 3. adımda “My Tweets” yerine “Hashtag” seçip takip etmek istediğiniz etiketi yazıyorsunuz (örneğin #MarkaAdiniz), o etiketle atılan herkese açık gönderiler toplanmaya başlıyor. Hesap bağlamanız gerekmiyor. Hashtag toplamayı da ücretsiz deneme süresinde, sınırlı çekme kotasıyla deneyebilirsiniz (paket ayrıntıları fiyatlandırma sayfasında, İngilizce).
Hashtag akışlarında gönderi denetimini mutlaka açın. Herkese açık etiketlere spam, konu dışı ve zaman zaman uygunsuz gönderi karışır. Akış ayarlarından ön onayı açtığınızda, siz onaylamadan hiçbir gönderi sitenizde görünmez. Bunu anahtar kelime filtreleriyle birleştirirseniz her gönderi yayına girmeden önce elden geçmiş olur. Etkinliklerde kullanım için etkinlik sosyal duvarı rehberimize (İngilizce) bakabilirsiniz.
Diğer platformlarla birlikte kullanım
X, gerçek zamanlı yorum ve gündem tarafını temsil ediyor; ama tek başına bir sosyal kanıt duvarı kurmaz. Aynı widget içinde farklı ağları birleştirebilirsiniz. Bu üç rehber Türkçe olarak yayında: Instagram akışını siteye ekleme, YouTube oynatma listesi ve kanal videolarını gömme ve Google yorumlarını siteye ekleme.
Sık sorulan sorular
X (Twitter) gömmem neden sitede görünmüyor?
En sık karşılaşılan beş neden şunlar: (1) twitter.com adresli eski bir gömme kodu, (2) yüklenmeyen widget.js betiği, (3) oturum açmamış ziyaretçiler için gelen okuma kısıtlamaları, (4) gömdüğünüz hesabın gizliye alınması ve (5) yalnızca düzenleme ekranını etkileyen Squarespace ile Webflow kısıtlamaları. Ekranda yalnızca “Posts by [hesabınız]” yazısı çıkıyorsa, sorun sizde değil: resmi zaman akışı gömmesinin kendisi bozuk ve kodu yeniden üretmek bunu çözmüyor. Bu durumda CollectSocials ile kurulan yöntemi değerlendirebilirsiniz.
X zaman akışımı ücretsiz gömebilir miyim?
Resmi publish.x.com ücretsiz, ancak testte görüldüğü gibi bugün yalnızca tek gönderi gömmesinde güvenilir sonuç veriyor. Zaman akışı ya da hashtag akışı için üçüncü taraf bir araca ihtiyacınız var ve X API'yi ücretlendirdiği için bu araçların hemen hepsinde X bağlantısı ücretli pakete ait. CollectSocials'ta zaman akışını da hashtag toplamayı da ücretsiz deneme süresinde sınırlı bir çekme kotasıyla deneyip sonucu kendi sitenizde görebilirsiniz.
Hashtag akışı gömülebiliyor mu?
Resmi araçla gömülemiyor; hashtag girdiğinizde yalnızca bir paylaşım butonu üretiliyor. CollectSocials gibi bir üçüncü taraf araçla ise mümkün: etiketi belirtiyorsunuz, herkese açık gönderiler toplanıyor, gönderi denetiminden geçtikten sonra sitenizde görünüyor.
WordPress'e X zaman akışını nasıl eklerim?
Gutenberg editöründe bir “Özel HTML” bloğu ekleyip CollectSocials'tan aldığınız gömme kodunu içine yapıştırmanız yeterli. Klasik editör kullanıyorsanız “Metin” sekmesine geçip kodu oraya yapıştırın. Bu yol eklenti gerektirmiyor, ancak CollectSocials bir WordPress eklentisi (İngilizce) de yayımlıyor. Trafik alan bir sayfada eklenti daha avantajlı: gönderileri ve yayımlanmış tasarımı kendi WordPress veritabanınıza kopyalayıp sizin alan adınızdan sunduğu için, ilk eşitlemeden sonra o sayfanın görüntülenmeleri paket sayacına işlemiyor; ücretsiz pakette de öyle. İlk eşitlemeden önce barındırılan gömme gösteriliyor.
Wix ve Squarespace'te de çalışıyor mu?
Çalışıyor. Bu iki servis dışarıdan gelen betikleri kısıtladığı için CollectSocials onlara iframe biçiminde kod veriyor: Wix'te HTML gömme öğesine, Squarespace'te kod bloğuna yapıştırıyorsunuz. Şunu da aklınızda tutun: Squarespace düzenleme ekranında betikler kapalı olduğu için görüntü bozuk görünebilir, yayımlanmış sayfada sorun olmaz.
Akış gerçekten canlı mı güncelleniyor?
Akış düzenli aralıklarla kendiliğinden eşitleniyor, yani elle yenileme ya da kodu yeniden gömme derdi yok. Ancak bu bir gerçek zamanlı yayın değil. Akış ayarlarındaki ön onay seçeneği, çekilmiş gönderilerin ne zaman görüneceğini kontrol etmenizi sağlar, fakat X kaynağının eşitleme aralığını kısaltmaz; etkinlik sırasında atılan bir gönderi duvara bir sonraki eşitlemeden sonra düşer.
CollectSocials ile bugün başlayın
Görünmeyen resmi gömme kodlarıyla uğraşmayın: kaynağı seçin, tasarımı seçin, kodu yapıştırın.