Social Feed Blocks: Instagram, YouTube, Google Reviews

Where to find it: Theme Editor → left panel Components → Social Media category · keys under Integrations → Social Media Who is it for: Anyone who wants Instagram posts, YouTube videos or Google business reviews to appear on the store pages automatically In short: Three new blocks fetch content from the external service with the keys you enter, cache it and render it on the storefront. Without a key the block is not rendered on the storefront; in the editor it shows sample content.

---

What does it do?

Visitors want to see a living brand: latest posts, new videos, real customer reviews. Copying these by hand is not sustainable. Social feed blocks automate it: you connect the service once, the block refreshes the content itself.

There are three blocks, all under the Social Media category:

How it works (short architecture)

1. You enter the keys on the Integrations page. Tokens and API keys are stored encrypted; they are never sent to the storefront.
2. The storefront never calls the external service. The Treyza server fetches the content, caches it for 30 minutes and hands the storefront a ready list. The visitor's browser makes no request to Instagram, the YouTube API or Google.
3. If the service does not respond, the last successful result keeps being shown for up to 24 hours; if there is none, the block is silently skipped.
4. Without a key the storefront does not render the block at all (no empty section is left behind). In the editor the block shows representative content tagged "sample", so you can design the layout before entering a key.

Step by step: connecting

Instagram Feed

Instagram shut down the old "Basic Display API" in December 2024. Treyza works with the Instagram API with Instagram Login (Graph API), which requires a professional (business or creator) Instagram account.

1. Create an app on developers.facebook.com and add the Instagram product.
2. Under Instagram API setup with Instagram login, add your account and generate a long-lived access token ("Generate token"). The numeric Instagram user ID is shown on the same screen.
3. In Treyza open Integrations → Social Media → Instagram Feed, paste the token and the user ID. Optionally enter https://www.instagram.com/username in Profile link; if left empty the link is built from the username.
4. Use Test Connection to see your account name, then enable the integration.

ℹToken lifetime: A long-lived token is valid for 60 days. Treyza refreshes it itself once it is older than 30 days; you do not need to generate a new token. If the refresh fails (for example the app was deleted) the block keeps the last successful content and the status line at the top of the block settings warns you.

YouTube Feed

1. No API key is needed. Treyza reads the channel's public RSS feed (latest 15 videos). Leave the key field empty; enter an optional Data API v3 key only if you want to list videos older than the latest 15 (the guide explains how to get one).
2. Find your channel ID: YouTube Studio → Settings → Channel → Advanced settings shows the Channel ID starting with UC; or simply enter your @handle.
3. To show only one list, enter the Playlist ID (the list= value in the address bar). Channel ID can be left empty when only a playlist ID is given.
4. Enter the ID under Integrations → Social Media → YouTube Feed, test (it should say "RSS, anahtarsız", Turkish for "RSS, no key"), enable.

Google Reviews

1. In the Google Cloud Console enable Places API (New) and create an API key.
2. Find your business's Place ID: search your business name on Google's Place ID finder page and copy the ID starting with ChIJ.
3. Enter the key and the Place ID under Integrations → Social Media → Google Reviews, pick the review language (Turkish / English), test, enable.

Block settings

Settings shared by all three blocks:

Block-specific settings:

Behaviour on the storefront

• Instagram items open the post in a new tab when clicked; video and album posts carry a small marker in the corner.
• YouTube videos are only a cover image until clicked; a click opens the privacy-friendly youtube-nocookie player. No request goes to YouTube while the page loads, so page speed and cookie compliance are preserved.
• Google reviews are rendered as cards; rating stars, author and a relative date like "2 weeks ago" come with the review.
• The block is rendered on the server with cached data; the content is ready when the visitor opens the page. In regions without a server feed, such as header and footer, the content completes right after the page opens.

Frequently asked questions

The block shows in the editor but not on the storefront. The integration is not connected or not enabled; check the status line at the top of the block settings. After connecting, it appears on the storefront within 5 minutes at most.

When does a new post appear? The cache is 30 minutes; saving the integration settings clears the cache immediately.

Do I have to refresh the Instagram token myself? No. Treyza refreshes a token older than 30 days itself. If the token became invalid (password changed, app deleted), generate a new token and paste it into the same screen.

Which sources were not added? TikTok, Pinterest and X feeds are not in this release; they were postponed because of TikTok's approval process and X's paid API.