Add live, location-based African news to any website or app. Embeddable news cards for top stories, featured content, and local news across 16 countries — free, no API key required.
Drop this snippet anywhere in your HTML. The widget auto-creates an iframe sized to the layout you choose.
<!-- 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>For full control, use the iframe URL directly with query parameters.
<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>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. Supported: ZW, KE, TZ, UG, RW, ET, BI, DJ, ER, SO, SS, KM, MG, MU, SC, ZA, BW, ZM, MW, NA, MZ, LS, SZ, AO, NG, GH, SN, CI, CM, BJ, BF, CV, GM, GN, GW, LR, ML, MR, NE, SL, TG, GQ, ST, CD, CG, CF, TD, GA, EG, MA, TN, DZ, LY, SD |
| 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) |
Visual card grid with images — ideal for sidebars and content areas.
<div data-mukoko-embed data-country="ZW" data-type="top" data-layout="cards" data-limit="4"></div>Single featured story with large image — great for ad-like placements and promotions.
<div data-mukoko-embed data-country="KE" data-type="featured" data-layout="hero"></div>Text-focused list — minimal footprint for narrow sidebars and sister app integration.
<div data-mukoko-embed data-country="NG" data-type="latest" data-layout="compact" data-limit="5"></div>Horizontal scrollable strip — perfect for headers, footers, and banner placements.
<div data-mukoko-embed data-country="ZA" data-type="top" data-layout="ticker" data-limit="8"></div>Classic list with thumbnails — the default feed-style embed.
<div data-mukoko-embed data-country="GH" data-type="latest" data-layout="list" data-limit="5"></div>Location-based embeds are critical for sister apps and regional content. Use the country parameter to target any of the 16 supported African countries.
<div data-mukoko-embed
data-country="KE"
data-type="location"
data-layout="cards"
data-limit="4">
</div>For embedding in other Mukoko apps (Weather, Sports, etc.), use the script widget. It handles responsive sizing and theme matching.
<!-- 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>