Placement & widgets
Three ways, from easiest to most precise.
1. Automatic placement
On the feed form, tick pages under Show On:
- Home Page
- Category Pages
- Product Pages
- CMS Pages
- Shopping Cart Page
Then pick a Placement Container — where on those pages the feed is appended:
| Container | Where it lands |
|---|---|
| Main content | Inside the page's content column (the default) |
| Left sidebar | The sidebar.main column |
| Right sidebar | The sidebar.additional column |
| Above content | Between the header and the content |
| Below content | Between the content and the footer |
| End of page | Last thing before </body> |
No code, no layout XML.
A sidebar has to exist on that page
The container must be present in that page's layout. The right sidebar only exists on 2-columns-right and 3-columns pages; the left sidebar only on 2-columns-left and 3-columns. Choose one the page does not have and the feed renders nowhere, silently.
Leave Show On empty to place the feed yourself with a widget or layout XML.
2. Widget — exact position, still no code
Content → Widgets → Add Widget
- Choose Instagram Feed as the widget type and your theme as the design.
- Add a Layout Update: pick where it appears (all pages, a category, a specific product, a CMS page) and which container.
- In Widget Options, choose the Feed by code.
- Optionally set a Title Override for this placement only.
Widgets also work inside CMS pages and blocks, so you can drop a feed into the middle of an article.
3. Layout XML — for developers
<referenceContainer name="content">
<block class="Webkul\InstagramFeed\Block\Feed" name="my.instagram.feed">
<arguments>
<argument name="code" xsi:type="string">homepage_feed</argument>
</arguments>
</block>
</referenceContainer>
Or reuse the shipped handle and override its arguments:
<update handle="instagramfeed_feed_render"/>
Several feeds on one page
Supported. Give each a distinct code; Sort Order decides which renders first when they share a container.
What if nothing appears?
An empty feed renders nothing at all — no empty frame, no heading. That is deliberate: a blank gallery looks worse than none. If you expected tiles, start with Troubleshooting.