Embed Location News Cards

Add live, location-based African news to any website or app. Embeddable news cards for top stories, featured content and local news — live in 34 African countries, with all 54 in scope. Free, no API key required.

Quick Start — Script Widget

Drop this snippet anywhere in your HTML. The widget auto-creates an iframe sized to the layout you choose.

HTML

<!-- Mukoko News Embed -->
<div data-mukoko-embed
     data-country="ZW"
     data-type="top"
     data-layout="cards">
</div>
<script src="https://news.mukoko.com/embed/widget.js" async></script>

Direct iframe Embed

For full control, use the iframe URL directly with query parameters.

HTML

<iframe
  src="https://news.mukoko.com/embed/iframe?country=KE&type=top&layout=cards&limit=6"
  width="420"
  height="600"
  frameborder="0"
  title="Kenya Top Stories — Mukoko News"
  style="border-radius: 12px; border: 1px solid #e5e5e5; max-width: 100%;"
></iframe>

Parameters

All parameters work with both the script widget (as data-* attributes) and the iframe URL (as query params).

Param	Type	Default	Description
country	string	ZW	Country code for location filtering. Live: NG, ZA, GH, ZW, SN, KE, CV, EG, MA, GA, ZM, GN, UG, DZ, CI, MW, NA, ET, CD, MZ, TZ, CM, SO, TG, BF, LS, AO, TN, LY, BJ, MU, LR, MG, TD. The other 20 African Union member states are accepted but have no articles yet.
type	enum	latest	Feed type — top (trending), featured (popular), latest (newest), location (local news)
layout	enum	cards	Visual layout — cards (grid), compact (text list), hero (single large card), ticker (horizontal scroll), list (thumbnail list)
limit	number	varies	Number of articles (1-20). Defaults: cards=6, compact=8, hero=1, ticker=10, list=10
category	string	—	Filter by category slug (politics, economy, sports, technology, etc.)
theme	enum	auto	Force a theme — light, dark, or auto (matches parent page)

Layout Examples

Cards Grid

Visual card grid with images — ideal for sidebars and content areas.

Example

<div data-mukoko-embed data-country="ZW" data-type="top" data-layout="cards" data-limit="4"></div>

Hero Card

Single featured story with large image — great for ad-like placements and promotions.

Example

<div data-mukoko-embed data-country="KE" data-type="featured" data-layout="hero"></div>

Compact List

Text-focused list — minimal footprint for narrow sidebars and sister app integration.

Example

<div data-mukoko-embed data-country="NG" data-type="latest" data-layout="compact" data-limit="5"></div>

Ticker (Horizontal Scroll)

Horizontal scrollable strip — perfect for headers, footers, and banner placements.

Example

<div data-mukoko-embed data-country="ZA" data-type="top" data-layout="ticker" data-limit="8"></div>

Thumbnail List

Classic list with thumbnails — the default feed-style embed.

Example

<div data-mukoko-embed data-country="GH" data-type="latest" data-layout="list" data-limit="5"></div>

Location-Based News

Location-based embeds are critical for sister apps and regional content. Use the country parameter to target any of the 34 live African countries below. The remaining 20 African Union member states are in scope and coming soon — the parameter accepts them, but there are no articles behind them yet.

🇿🇼ZW

🇰🇪KE

🇹🇿TZ

🇺🇬UG

🇪🇹ET

🇸🇴SO

🇲🇬MG

🇲🇺MU

🇿🇦ZA

🇿🇲ZM

🇲🇼MW

🇳🇦NA

🇲🇿MZ

🇱🇸LS

🇦🇴AO

🇳🇬NG

🇬🇭GH

🇸🇳SN

🇨🇮CI

🇨🇲CM

🇧🇯BJ

🇧🇫BF

🇨🇻CV

🇬🇳GN

🇱🇷LR

🇹🇬TG

🇨🇩CD

🇹🇩TD

🇬🇦GA

🇪🇬EG

🇲🇦MA

🇹🇳TN

🇩🇿DZ

🇱🇾LY

Kenya Location News

<div data-mukoko-embed
     data-country="KE"
     data-type="location"
     data-layout="cards"
     data-limit="4">
</div>

Sister App Integration

For embedding in other Mukoko apps (Weather, Sports, etc.), use the script widget. It handles responsive sizing and theme matching.

weather.mukoko.com example

<!-- In your app's sidebar or content area -->
<div data-mukoko-embed
     data-country="ZW"
     data-type="location"
     data-layout="compact"
     data-limit="5"
     data-theme="dark">
</div>
<script src="https://news.mukoko.com/embed/widget.js" async></script>

Features

Location-based news from 34 live African countries (54 in scope)
4 feed types: Top Stories, Featured, Latest, Location
5 visual layouts: Cards, Compact, Hero, Ticker, List
Category filtering (politics, sports, economy, tech, etc.)
Auto-refreshes every 5 minutes
Respects system dark/light theme or forced via parameter
Links open in a new tab (won't navigate away from your page)
Sandboxed iframes for security
Lightweight widget script — under 2 KB
No API key required