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

# Introduction

> PolyEmbed matches each article to its live Polymarket market and lets readers trade without leaving the page.

PolyEmbed is a widget for publishers. You add one embed snippet to your article template, and every story shows the live [Polymarket](https://polymarket.com) prediction market that best matches its headline. Readers can follow the odds, or connect a wallet and trade inside the article. You earn a share of the builder fees on trades placed from your pages.

> **[Quickstart](https://docs.polyembed.io/get-started/quickstart.md)**
>
> Go from sign-up to live odds in your stories in four steps.

> **[How it works](https://docs.polyembed.io/get-started/how-it-works.md)**
>
> What happens between a page load and a matched market.

> **[Install the widget](https://docs.polyembed.io/install/html-embed.md)**
>
> The iframe snippet, the WordPress shortcode and CMS template examples.

> **[Earnings](https://docs.polyembed.io/publishers/earnings.md)**
>
> How the revenue share is calculated and paid.

## What you get

* **No market picking.** The widget searches Polymarket with each article's title and keywords on every page load, and ranks results by relevance, liquidity and freshness.
* **No empty boxes.** When no relevant market is live, the widget collapses to zero height.
* **Trading in the article.** Readers sign in with email or their own wallet, fund a Polymarket deposit wallet, and buy or sell outcome shares. Polymarket's relayer covers gas.
* **Per-article analytics.** Impressions, Polymarket clicks, interaction rate and widget errors for every widget.
* **Revenue share.** You keep 70% of the builder fees on trades from your pages, paid Net-30.

## Who these docs are for

**Publishers**

Start with the [Quickstart](https://docs.polyembed.io/get-started/quickstart.md). The [Publisher setup](https://docs.polyembed.io/publishers/account.md) and [Install the widget](https://docs.polyembed.io/install/html-embed.md) sections cover each step in detail, and the [Reference](https://docs.polyembed.io/reference/embed-url.md) tab documents every parameter and message the widget uses.

**Readers**

If you found a PolyEmbed widget in an article, read [Trading in the widget](https://docs.polyembed.io/readers/trading.md), [Funding your wallet](https://docs.polyembed.io/readers/funding.md) and [Where trading is available](https://docs.polyembed.io/readers/availability.md).

## See it live

* [The Headline Herald](https://demo.polyembed.io) is a demo newsroom running the production widget on real articles.
* The [live demo](https://polyembed.io/#demo) on the PolyEmbed home page matches any headline you type.

> [!NOTE]
>
> PolyEmbed is not financial advice. Prediction market prices move quickly and trades can lose value. PolyEmbed routes orders to Polymarket and does not guarantee execution, liquidity, profitability or availability. See the [trading risk disclosure](https://polyembed.io/policies/trading-risk).


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