Add to Feedings Button & ShareDing! Links

How It Works

When someone clicks your "Add to Feedings" button:

1. If they have the Feedings app installed, it opens directly with your feed pre-loaded
2. If they don't have the app, they'll be prompted to download it
3. Your feed is automatically added to their subscription list

Advanced: ShareDing! Deep Links

For developers who want to share individual articles or items (not just RSS feeds), you can use our feedings:// deep link format.

Sharing an Article/Item

To share a specific article, create a deep link with a base64-encoded JSON payload:

The JSON payload structure:

{
  "version": 1,
  "type": "item",
  "data": {
    "title": "Article Title",
    "link": "https://example.com/article",
    "description": "Article description or excerpt",
    "pubDate": "2025-01-15T10:00:00Z",
    "source": "Your Site Name",
    "sourceColor": "#00baff",
    "thumbnail": "https://example.com/image.jpg",
    "sourceUrl": "https://example.com/feed.xml"
  },
  "timestamp": 1736935200000
}

JavaScript Example

// Create the payload
const payload = {
  version: 1,
  type: "item",
  data: {
    title: "My Article Title",
    link: "https://myblog.com/article",
    description: "A short description...",
    pubDate: new Date().toISOString(),
    source: "My Blog",
    sourceColor: "#00baff",
    thumbnail: "https://myblog.com/thumb.jpg",
    sourceUrl: "https://myblog.com/feed.xml"
  },
  timestamp: Date.now()
};

// Encode to base64
const json = JSON.stringify(payload);
const base64 = btoa(json);

// Create the deep link
const deepLink = `feedings://share?data=${base64}`;

// Use in a link
console.log(deepLink);

Sharing an RSS Source

You can also share an RSS feed source with metadata:

{
  "version": 1,
  "type": "source",
  "data": {
    "name": "Your Site Name",
    "url": "https://example.com/feed.xml",
    "type": "rss",
    "color": "#00baff",
    "category": "Technology"
  },
  "timestamp": 1736935200000
}

Supported Formats

The button supports these RSS/feed protocols:

• https:// - Standard RSS feeds
• feed:// - Feed protocol (automatically converted)
• rss:// - RSS protocol (automatically converted)

Two Ways to Add the Button

Option 1: Use Our Button Image (Recommended)

This is the easiest option - just copy and paste! The button image is hosted by us, so it always works and always looks great.

<a href="feed://yourfeed.com/feed.xml">
  <img src="https://feedings.co.uk/addto.png" alt="Add to Feedings" style="height: 48px;">
</a>

✅ Pros: Always up-to-date, professional look, no hosting needed

Option 2: Custom HTML Button

Create your own styled button with custom colors and text. You can modify the styling to match your website.

<a href="feed://yourfeed.com/feed.xml" 
   style="display: inline-block; padding: 12px 24px; 
          background: #00baff; color: #000; 
          text-decoration: none; border-radius: 8px; 
          font-weight: bold; border: 2px solid #000;">
  📰 Add to Feedings
</a>

✅ Pros: Fully customizable, matches your site's design

WordPress Plugin

If you use WordPress, you can add this code to your theme's functions.php:

function add_feedings_button() {
    $feed_url = get_bloginfo('rss2_url');
    echo '<a href="feed://' . $feed_url . '" 
             class="feedings-button">
            📡 Subscribe in Feedings
          </a>';
}
add_action('wp_footer', 'add_feedings_button');

Why Add This Button?

• Make it easier for readers to follow your content
• Increase RSS subscriptions
• Better reader retention
• Direct connection with your audience
• No third-party tracking or cookies

Questions?

Need help setting up your button? Contact us at support@feedings.co.uk

POST https://share.feedings.co.uk/create
Content-Type: application/json

{
  "version": 1,
  "type": "item",
  "data": { ... }
}