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

# RSS Feed Importer

> Turn articles from your RSS feeds into audio.

<Info>
  You will need to install the BeyondWords Player separately.
</Info>

## Overview

The RSS Feed Importer allows you to automatically convert articles from your RSS feeds into audio. Once enabled, BeyondWords will regularly check your feeds for new content and generate audio for each new article.

## Add a new feed

To get started go to **Project > Settings > Integrations > RSS Feed Importer**.

<Steps>
  <Step title="Click + Feed">
    Click the **+ Feed** button.
  </Step>

  <Step title="Select Feed type">
    Select the type of feed you want to add. You can choose between **XML** and **JSON**.
  </Step>

  <Step title="Add Feed URL">
    Enter the URL of your RSS feed.
  </Step>

  <Step title="Set request headers (optional)">
    For **paywalled or protected content**, you may need to provide authentication headers.

    * Add a **Header Name** and **Header Value** to authenticate requests.
    * Click **+** to add multiple headers if needed.
  </Step>

  <Step title="Enable Static IP (optional)">
    If your website requires **IP allowlisting**, enable this option to use a **static IP** for content extraction.
  </Step>

  <Step title="Enable page extraction (optional)">
    If your RSS feed only contains article links and not the full text, BeyondWords can fetch the content from article URLs.

    * If your articles are protected or behind a paywall and you need to set up [request headers](/docs-and-guides/integrations/extraction/content-extraction#request-headers) or a [static IP](/docs-and-guides/integrations/extraction/content-extraction#static-ip) this can be set up in [extraction settings](/docs-and-guides/integrations/extraction/content-extraction).
  </Step>
</Steps>

## Map the feed

After adding your feed, you'll need to map the RSS feed fields to BeyondWords article properties. This ensures the correct information - such as titles, descriptions, and content - is used to generate audio.

<Steps>
  <Step title="Required fields">
    Map these required fields from your feed:

    * **Title**: Select the field containing the article title
    * **Body**: Select the field containing the article content
    * **Source ID**: Select the field containing a unique identifier for each article (usually corresponds to your article ID in your CMS). This ID can be used to easily embed the audio on your articles using the BeyondWords Player.
    * **Source URL**: Select the field containing the URL for each article. This URL can also be used to easily embed the audio on your articles using the BeyondWords Player.
  </Step>

  <Step title="Optional fields">
    You can also map these optional fields:

    * **Summary**: Select the field containing a summary of the article. You can leave this empty if you use BeyondWords summarization.
    * **Author**: Select the field containing the article author's name
    * **Image URL**: Select the field containing the URL of the article's featured image
    * **Metadata**: Select the field containing additional metadata about the article
    * **Publish date**: Select the field containing when the article was published
          <Info>
            The publish date is used to check for updates to articles. When BeyondWords detects a change in the publish date, it will update the audio for that article.
          </Info>
  </Step>

  <Step title="Save and activate">
    Click **Save changes** to complete the setup. Your feed will automatically be enabled and BeyondWords will begin checking for articles.
  </Step>
</Steps>

## Managing your feed

Once your feed is set up:

* BeyondWords will automatically check your feed every 10 minutes for new or updated articles
* You can manually trigger an import by clicking the **⋯** button next to your feed and selecting **Run**
* New articles will be processed and converted to audio automatically
* Updated articles (detected by changes in the publish date) will have their audio updated

## Embed the Player

You can embed the audio on your website using either the Source ID or Source URL you mapped during setup.

<Card title="Embed the BeyondWords Player" icon="play" href="/docs-and-guides/distribution/player/overview">
  Once your content is imported and converted to audio, learn how to embed the BeyondWords Player on your website to deliver a seamless audio experience to your audience.
</Card>