Overview
The Feed component allows you to embed a LiveWhale news or events feed directly into a page. This is the preferred method for displaying dynamic news and event listings in Site Builder.
Visit the IU Developers site for more information about LiveWhale.
Common uses
- Display a news feed with the latest announcements
- Embed an events feed directly on a section landing page
- Highlight upcoming events or recent stories without manually updating the page
Component example
Component fields
| Element name | Required | Multiple |
|---|---|---|
|
Feed URL
URL of the LiveWhale feed to display. Must be an External Link created using Add Content → Add Link.
|
Yes
|
No
|
|
Maximum items
Number of items to display (2–9) or Automatic.
|
Yes
|
No
|
|
Advanced settings
See Advanced Component Fields.
|
No
|
No
|
Generating feed URLs
Before you can add a feed to your page, you'll need to generate a feed URL using the appropriate feed builder.
-
Use the LiveWhale Storyteller Feed Builder to generate feeds for news and stories
-
Use the LiveWhale Events Calendar Feed Builder to generate feeds for events
Rather than pasting the URL directly into the Feed component, create an External Link asset in the WCMS:
-
Go to Add Content → Add Link.
-
Choose Reusable Link to Another Website.
-
Give the link a descriptive name (for example,
Admissions News FeedorUpcoming Events Feed). -
Paste the generated feed URL into the URL field.
-
Save the External Link.
You can then select the External Link asset in your Feed component using the asset chooser. Creating an External Link asset makes feed URLs easier to reuse and update across your site.
IU Web Framework sites use an older version of LiveWhale feed URLs that isn't compatible with Site Builder.
If you're migrating content from a Web Framework site, generate a new feed URL using the appropriate feed builder, then create a new External Link asset instead of reusing the old URL.
Accessibility
-
Use descriptive feed item titlesMake sure news and event items in LiveWhale have clear titles before embedding, so users understand each link’s purpose.
-
Limit the number of itemsKeep feeds as short as possible to avoid overwhelming readers and to improve scannability.
-
Provide context with a headingAdd a heading like Latest News or Upcoming Events above the feed so screen reader users know what the list represents.
Do
- Use to display news or event feeds from LiveWhale
- Keep feeds concise with a reasonable max item count
- Provide a clear heading or label for the feed on your page
- Follow LiveWhale best practices when creating news items and events
Don't
- Embed more than one feed per page
- Use the Code component to embed a LiveWhale feed—always use the Feed component
- Use to embed a non-LiveWhale feed—use the Code component instead