> ## Documentation Index
> Fetch the complete documentation index at: https://help.lobyco.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Feeds

> Build a feed post inside a campaign, with text, an image or a video, and publish it to the app.

A feed is a short post on the app's home screen, made of text, an image or a video. Customers take it in at a glance, and it can invite them to read more or tap through. This page helps you create one inside a campaign and publish it.

> [!NOTE]
>
> A feed always belongs to a campaign. Open the campaign first, or [create one](/business-documentation/campaigns/create-a-campaign).

## Add a feed to your campaign

You can add a feed in the campaign's **List** view or on its [orchestration canvas](/business-documentation/campaigns/orchestration-canvas). Either way, the **Create Feed** form opens.

Add it on the canvas when a flow decides who sees the feed. [Recipients](/business-documentation/communication/triggering) explains how a flow sends a feed.

**In the list**

1. Go to **Campaigns** and open the campaign the feed belongs to, or [create a new one](/business-documentation/campaigns/create-a-campaign).
2. Select **Add activities**, or **Add activity** if the campaign already has some.
3. On the **Select an activity** page, point at the **Feed** tile and select **From scratch**. To start from a saved feed instead, select **From template**. [Reuse with templates](/business-documentation/campaigns/reuse-with-templates) explains how.

**On the canvas**

1. Go to **Campaigns** and open the campaign the feed belongs to, or [create a new one](/business-documentation/campaigns/create-a-campaign).
2. Select **Orchestration** at the top.
3. In the **Block library**, drag a **Feed** block from the **Activity** group onto the canvas.
4. Double-click the block. **Create Activity** opens.
5. Select **From Scratch**. To start from a saved feed instead, select **From Template**. [Reuse with templates](/business-documentation/campaigns/reuse-with-templates) explains how.

Once you've saved the form, connect the block to its flow and select **Save** at the top right of the canvas. Connect it before you publish the feed, because you can't connect or disconnect it after that. When another block connects into the feed, the flow decides who gets it, and its **Segmentation** changes. [What changes in the form](/business-documentation/communication/triggering#what-changes-in-the-form) explains how.

## Fill in Feed details

| Field | What it does |
| - | - |
| **Name** | Names the feed in the portal, such as `LemonadeRecipeFeed`. Up to 100 characters. Customers don't see it. |
| **Analytics identifier** | A unique ID for following the feed in your analytics, such as `feed-1234-5432`. Optional, up to 50 characters. |
| **Feed type** | Sets what kind of feed this is, and which fields the rest of the form shows. You only see it if your app has more than one feed type. Otherwise every feed is an **Inspiration** feed. |
| **Choose chain(s)** | Shows the feed only to customers in the chains you pick. Leave it on **All chains** to show it in every chain. Only for **Inspiration** feeds. |

Lobyco sets up which feed types your app has. Each one changes the form a little:

| Feed type | How the form differs |
| - | - |
| **Inspiration** | The standard feed, for content that inspires or informs customers. For example, recipes, campaign news and retailer updates. It has **Display priority** and **Choose chain(s)**. |
| **GreenNews** | For content about sustainability, such as green tips and eco-friendly campaigns. It shows on the app's Green Universe screen. It has no **Display priority** or chain field. Its counters recommend different lengths, and image and video feeds get a **Long description**. The preview shows the feed twice, as a card and opened. |
| **PartnerBenefit**, **PartnerBenefitBanner** | Feeds for a partner's offer, with a different form. See [Partner benefit feeds](/business-documentation/communication/partner-benefit-feeds). |

## Write the feed content

Open **Content type** and pick **Text**, **Image** or **Video**. The **Feed content** section then opens below. If you switch to **Text** later, the form clears the image and video you added.

Fill in **Feed content**. **Preview** shows the feed as you type.

| Field | What it does |
| - | - |
| **Display priority** | Sets the feed's priority in the app. A lower number means a higher priority. Feeds are ordered by priority first, then by start date, newest first. It starts at your app's default. |
| **Title** | The feed's headline. |
| **Text** | The message, for a **Text** feed. |
| **Top message text** / **Bottom message text** | The message above and below the image or video. Fill in at least one of them. |
| **Upload image** | The image, for an **Image** feed. Choose **URL** to link to an image, or **Image** to upload one. Uploads can be PNG or JPG, up to 2 MB. |
| **Video URL** | The video, for a **Video** feed. Choose **URL** to link to it, or **Video** to upload one. Uploads can be MP4, MOV, AVI or QT, up to 30 MB. |
| **Upload thumbnail image** | The still image customers see before the video plays. Link to it or upload it, as for **Upload image**. |
| **Long description** | Longer text that only shows when the customer opens the feed, not on the feed itself. **GreenNews** image and video feeds only. |

To swap an uploaded image or video for another, select **Change file**.

When the feed's block is connected after a block that passes on customer details, you can add those details to **Text**, **Top message text** or **Bottom message text**. Type `{` and pick one from the list. It shows in the text in braces, such as `{CustomerId}`, and each customer sees their own value. **Title** doesn't take them. See [Personalise a triggered communication](/business-documentation/communication/triggering#personalise-a-triggered-communication).

Under **Title** and each message, a counter shows your characters against the length the portal recommends. The recommended lengths depend on the feed type, and on which home screen design your app uses. One design scrolls down, and the other has rows that scroll sideways. On an **Inspiration** image or video feed, the two messages share one count. You can type past it, but the portal recommends staying within it.

![The Create Feed form with the side menu collapsed. Feed details shows Name Coffee week tips, an empty Analytics identifier, Feed type Inspiration, and Choose chain(s) left at All chains. Content type is set to Image. In Feed content, Display priority is 4, Title reads Three ways to enjoy coffee week with the counter 31/80, Top message text reads New roast every day, Upload image has Image selected with the uploaded test picture and a Crop image button, and Bottom message text reads 2 for 1 all week. Both message counters show 35/140. Add button is unticked. The Preview on the right shows the title, the top message, the coffee cup picture and the bottom message, in that order.](https://mintcdn.com/lobyco-4c9fb3ad/rG971_5ZfS49bcjM/images/feeds-01-feed-content-with-its-preview.png?fit=max\&auto=format\&n=rG971_5ZfS49bcjM\&q=85\&s=097cde4d3da371f9461c48f0434bca0e)

*Feed content with its preview*

## Add a button

A button takes customers somewhere when they tap it. It's optional. To add one, tick **Add button**.

| Field | What it does |
| - | - |
| **Button text** | The label on the button. Up to 32 characters. |
| **In-app navigation** | Sends customers to a screen in the app. Pick the screen under **Choose from list**. See [Deeplinks](/business-documentation/communication/deeplinks). |
| **Navigate to external URL** | Sends customers to a website. Enter its address. |
| **Show external links in web wrapper** | Opens the website inside the app, with the app's header and menu around it, instead of in the phone's browser. Only for **Navigate to external URL**. |

## Choose who sees the feed

Open **Segmentation**.

| Field | What it does |
| - | - |
| **By stores** | Shows the feed only to customers tied to one of the stores you pick. Leave it on **All** for every store in the chains you chose under **Choose chain(s)**, or in every chain. |
| **By customers** | **All customers** shows the feed to every customer the store and chain settings allow. **Audience** narrows it to the audiences you pick. |

When you choose **Audience**, more options open:

* **Select Audience** picks saved audiences. Choose **Select from list** to pick them, or **Create new audience** to make a new one. The list shows audiences that are set up for feeds. You build audiences in [Segments and Audiences](/business-documentation/audiences-and-data).
* **Select Snapshots** picks a snapshot of an audience instead.

If the feed's block is connected to another block on the Orchestration canvas, the flow decides who gets the feed. **By customers** then shows **Custom segment**, and you can't change it. An extra section, **Add triggered details**, asks for **Validity period of feed**. Leave it empty and the feed stays until its end date. [Recipients](/business-documentation/communication/triggering) explains how this works.

## Set when the feed shows

Open **Schedule**. **Start date** and **End date** are the local date and time the feed starts and stops showing in the app. If the campaign has dates, both start with them. You can narrow them, but they have to stay within the campaign's dates. A date outside them shows an error under the field. To give the feed wider dates, change the campaign's dates first. Set the end date in the future, after the start date.

## Save or publish

* **Save** keeps the feed as a draft. You can save once it has a **Name**, **Feed type**, **Content type** and **Title**. A draft doesn't show in the app, whatever its dates. You can keep changing it.
* **Publish** stays greyed out until every required field is filled in. An empty required field turns red once you've clicked into it and out again. Once you change one of the fields **Save** needs, any of them that are still empty turn red together. The portal asks you to confirm, and says whether the feed becomes active now or on its start date.
* **Cancel** closes the form. If you have unsaved changes, the portal asks whether to **Stay** or **Discard changes**.

Once the feed is saved, the arrow beside **Save** offers **Save as template**. See [Reuse with templates](/business-documentation/campaigns/reuse-with-templates).

You'll know it worked when the feed shows in the campaign's **List** view with its new status. What each status means, and what you can still change after publishing, is in [Lifecycle](/business-documentation/communication/lifecycle).

## Other feeds in the app

Two other kinds of feed can show in the app, but you don't create them here:

* Purchase feeds reach customers on their own after each purchase. They show the receipt and bonus information, and ask for feedback on the purchase. Whether your app has them is part of how it's set up.
* Local communications are posts from store staff for the customers of their store, such as local offers, news, polls and events. They come in from a separate system and show alongside your other feeds.

## Troubleshooting

> **Why can't I edit this feed?**
>
> The form is read-only once the feed has expired, and when its campaign can no longer be changed. See [Lifecycle](/business-documentation/communication/lifecycle).

If none of these answers your question, contact Lobyco support. Send them the campaign's name and the feed's ID, from the top of **Feed details**.

## Related

* [Partner benefit feeds](/business-documentation/communication/partner-benefit-feeds) — the feed types for a partner's offer, and their form.
* [Recipients](/business-documentation/communication/triggering) — how a flow on the Orchestration canvas sends a feed to the customers it picks.
* [Lifecycle](/business-documentation/communication/lifecycle) — what each status means, and what you can change after publishing.
* [Deeplinks](/business-documentation/communication/deeplinks) — the app screens a button can open.
* [Add an activity](/business-documentation/campaigns/create-a-campaign#add-an-activity) — every way to add a feed to a campaign.
* [Reuse with templates](/business-documentation/campaigns/reuse-with-templates) — start a new feed from a saved one.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.