diff --git a/content/blog/best-affiliate-software-saas.mdx b/content/blog/best-affiliate-software-saas.mdx
index c1171f4e..e00acc7f 100644
--- a/content/blog/best-affiliate-software-saas.mdx
+++ b/content/blog/best-affiliate-software-saas.mdx
@@ -1,6 +1,7 @@
---
title: "Best Affiliate Software for SaaS 2026: Pricing, Fees and 19 Tools Compared (Checked Oct 2026)"
description: "Which affiliate software to choose for a SaaS, checked against each vendor's own pricing page in October 2026: what 19 tools cost before the first sale and after a program earns, which have no monthly fee and how their free plans are capped, what a second program costs, and who brings the affiliates."
+metaDescription: "Best affiliate software for SaaS: what 19 tools cost before and after the first sale and who brings affiliates, including Affitor at $0 until $10K."
date: "2026-07-05"
updated: "2026-11-12"
category: "Comparison"
diff --git a/content/blog/dub-vs-partnerstack.mdx b/content/blog/dub-vs-partnerstack.mdx
index a31e9ae1..d8858b6e 100644
--- a/content/blog/dub-vs-partnerstack.mdx
+++ b/content/blog/dub-vs-partnerstack.mdx
@@ -1,6 +1,7 @@
---
title: "Dub vs PartnerStack: Pricing, Contracts and Features Compared (Checked Oct 2026)"
description: "Dub Partners publishes its prices, from $90 a month plus a 5% payout fee, and you can cancel any time. PartnerStack prices after a demo, on one-year renewing terms, and includes its partner marketplace on the entry plan. Checked on both vendors' pages on October 12, 2026."
+metaDescription: "Dub vs PartnerStack: published prices from $90/month, or demo pricing on one-year terms with a partner marketplace, and where Affitor ($0 until $10K) fits."
date: "2026-10-13"
updated: "2026-10-17"
category: "Comparison"
diff --git a/content/blog/dub-vs-tolt.mdx b/content/blog/dub-vs-tolt.mdx
index 3f5429d2..da390119 100644
--- a/content/blog/dub-vs-tolt.mdx
+++ b/content/blog/dub-vs-tolt.mdx
@@ -1,6 +1,7 @@
---
title: "Dub vs Tolt: Pricing, Payout Fees and Features Compared (Checked Oct 2026)"
description: "Tolt starts at $99 a month for up to $20,000 a month in affiliate revenue, with unlimited affiliates and automatic payouts on every plan, plus a 2% fee. Dub Partners starts at $90 a month plus a 5% payout fee, and sends payouts and handles tax forms on that plan. Checked on both pricing pages on October 12, 2026; Tolt re-checked November 12, 2026."
+metaDescription: "Dub vs Tolt: $90/month plus a 5% payout fee with tax forms handled, or $99/month plus a 2% fee with automatic payouts, and where Affitor ($0 until $10K) fits."
date: "2026-10-13"
updated: "2026-11-12"
category: "Comparison"
diff --git a/content/blog/firstpromoter-alternatives.mdx b/content/blog/firstpromoter-alternatives.mdx
index 8168a216..d64f3407 100644
--- a/content/blog/firstpromoter-alternatives.mdx
+++ b/content/blog/firstpromoter-alternatives.mdx
@@ -1,6 +1,7 @@
---
title: "Best FirstPromoter Alternatives for SaaS in 2026 (5 Tools Compared)"
description: "Five honest FirstPromoter alternatives for SaaS: Affitor, Rewardful, Tolt, Dub Partners, and PartnerStack. Pricing checked October 2026, attribution trade-offs, and a straight answer on who should pick what."
+metaDescription: "Five honest FirstPromoter alternatives for SaaS: Affitor ($0 until $10K), Rewardful, Tolt, Dub and PartnerStack. Its $5K revenue cap and who should pick what."
date: "2026-07-05"
updated: "2026-11-12"
category: Comparison
diff --git a/content/blog/firstpromoter-vs-dub.mdx b/content/blog/firstpromoter-vs-dub.mdx
index dc38696e..0a5b42fc 100644
--- a/content/blog/firstpromoter-vs-dub.mdx
+++ b/content/blog/firstpromoter-vs-dub.mdx
@@ -1,6 +1,7 @@
---
title: "FirstPromoter vs Dub: Pricing, Fees and Features Compared (Checked Oct 2026)"
description: "FirstPromoter starts at $49 a month with no fees listed and native support for five billing systems. Dub Partners starts at $90 a month plus a 5% payout fee, and sends payouts and handles tax forms on that plan. Checked on both pricing pages on October 12, 2026."
+metaDescription: "FirstPromoter vs Dub: $49/month with no fees listed, or $90/month plus a 5% payout fee with tax forms handled, and where Affitor ($0 until $10K) fits."
date: "2026-10-13"
updated: "2026-10-17"
category: "Comparison"
diff --git a/content/blog/how-to-start-saas-affiliate-program.mdx b/content/blog/how-to-start-saas-affiliate-program.mdx
index bd1a97de..f8d771a9 100644
--- a/content/blog/how-to-start-saas-affiliate-program.mdx
+++ b/content/blog/how-to-start-saas-affiliate-program.mdx
@@ -1,6 +1,7 @@
---
title: "How to Start an Affiliate Program for Your SaaS (Step-by-Step Guide 2026)"
description: "Six steps take you from no program to your first partner payout: commission, software, tracking, recruiting, payout terms, and what to measure, with 2026 benchmarks and pricing checked October 2026."
+metaDescription: "Start a SaaS affiliate program in six steps: set a 20–25% commission, pick software (Affitor is $0 until $10K), hand-recruit 5–20 partners, measure for 90 days."
date: '2026-07-05'
updated: '2026-11-12'
category: Guide
diff --git a/content/blog/partnerstack-alternatives.mdx b/content/blog/partnerstack-alternatives.mdx
index ca396a51..a1107e73 100644
--- a/content/blog/partnerstack-alternatives.mdx
+++ b/content/blog/partnerstack-alternatives.mdx
@@ -1,6 +1,7 @@
---
title: "Best PartnerStack Alternatives in 2026 (5 Tools Compared)"
description: "PartnerStack does not publish its prices: every plan is priced during a demo. Here is what its plans include, who should pay for it, and five self-serve alternatives with pricing checked in October 2026."
+metaDescription: "Best PartnerStack alternatives for small SaaS: Affitor ($0 until $10K), Rewardful, FirstPromoter, Tolt and Dub. Demo-only pricing and who should pick what."
date: '2026-07-05'
updated: '2026-11-12'
category: Comparison
diff --git a/content/blog/partnerstack-vs-rewardful.mdx b/content/blog/partnerstack-vs-rewardful.mdx
index 1b645b85..4783e62e 100644
--- a/content/blog/partnerstack-vs-rewardful.mdx
+++ b/content/blog/partnerstack-vs-rewardful.mdx
@@ -1,6 +1,7 @@
---
title: "PartnerStack vs Rewardful: Which Should Your SaaS Pick in 2026?"
description: "One prices you in a sales demo, the other starts at $49 a month: they aren't really the same tool. A straight comparison of the enterprise PRM versus the focused affiliate app, with every price checked against both pages in October 2026, plus Affitor, the $0/month option that starts where they both charge."
+metaDescription: "Rewardful vs PartnerStack: a focused $49/month affiliate app or an enterprise PRM priced in a sales demo? Which fits your stage, plus Affitor at $0 until $10K."
date: '2026-07-06'
updated: '2026-10-17'
category: Comparison
diff --git a/content/blog/rewardful-alternatives.mdx b/content/blog/rewardful-alternatives.mdx
index 1f1d4175..a3f71ba6 100644
--- a/content/blog/rewardful-alternatives.mdx
+++ b/content/blog/rewardful-alternatives.mdx
@@ -1,6 +1,7 @@
---
title: "Best Rewardful Alternatives for SaaS in 2026 (5 Tools Compared)"
description: "Five honest Rewardful alternatives for SaaS on Stripe: Affitor, FirstPromoter, Tolt, Dub Partners, and PartnerStack. Pricing checked October 2026, attribution trade-offs, and a straight answer on who should pick what."
+metaDescription: "Best Rewardful alternatives for SaaS on Stripe: Affitor ($0 until $10K), FirstPromoter, Tolt, Dub and PartnerStack. Rewardful's caps and who should pick what."
date: "2026-07-05"
updated: "2026-11-12"
category: Comparison
diff --git a/content/blog/rewardful-vs-dub.mdx b/content/blog/rewardful-vs-dub.mdx
index 27373134..e5283943 100644
--- a/content/blog/rewardful-vs-dub.mdx
+++ b/content/blog/rewardful-vs-dub.mdx
@@ -1,6 +1,7 @@
---
title: "Rewardful vs Dub: Pricing, Fees and Features Compared (Checked Oct 2026)"
description: "Rewardful starts at $49 a month with a 0% transaction fee and unlimited affiliates. Dub Partners starts at $90 a month plus a 5% payout fee, and sends payouts and handles tax forms on that plan. Prices, limits and features checked on both pricing pages on October 12, 2026."
+metaDescription: "Rewardful vs Dub: $49/month with a 0% transaction fee, or $90/month plus a 5% payout fee with tax forms handled, and where Affitor ($0 until $10K) fits."
date: "2026-10-13"
updated: "2026-10-17"
category: "Comparison"
diff --git a/content/blog/rewardful-vs-firstpromoter.mdx b/content/blog/rewardful-vs-firstpromoter.mdx
index 6f2365b7..aba063c1 100644
--- a/content/blog/rewardful-vs-firstpromoter.mdx
+++ b/content/blog/rewardful-vs-firstpromoter.mdx
@@ -1,6 +1,7 @@
---
title: "Rewardful vs FirstPromoter: Which Is Best for SaaS in 2026?"
description: "Same $49 floor, different ceilings: revenue caps, plan limits, and billing coverage decide this one. Every number checked against both pricing pages in October 2026, plus Affitor, the $0/month option neither compare page mentions."
+metaDescription: "Rewardful vs FirstPromoter: which is better for SaaS? Same $49 floor, different ceilings: revenue caps and billing coverage, plus Affitor at $0 until $10K."
date: '2026-07-05'
updated: '2026-10-17'
category: Comparison
diff --git a/content/blog/stripe-affiliate-program.mdx b/content/blog/stripe-affiliate-program.mdx
index aaaeeba4..386dfd65 100644
--- a/content/blog/stripe-affiliate-program.mdx
+++ b/content/blog/stripe-affiliate-program.mdx
@@ -1,6 +1,7 @@
---
title: "Best Affiliate Tracking Software for Stripe in 2026 (8 Tools Compared)"
description: "Eight Stripe affiliate tracking tools compared on what they read from Stripe, price, fees, revenue caps and the catch, with every price checked on October 12, 2026. Then a four-step Affitor setup that ends with a test click, signup and sale."
+metaDescription: "Best affiliate tracking software for Stripe: 8 tools compared on price and fees, then a four-step setup on Affitor ($0 until $10K) that ends with a test sale."
date: '2026-07-05'
updated: '2026-11-12'
category: Comparison
diff --git a/content/blog/tolt-alternatives.mdx b/content/blog/tolt-alternatives.mdx
index cd509830..067fd8f5 100644
--- a/content/blog/tolt-alternatives.mdx
+++ b/content/blog/tolt-alternatives.mdx
@@ -1,6 +1,7 @@
---
title: "Best Tolt Alternatives for SaaS in 2026 (5 Tools Compared)"
description: "Five honest Tolt alternatives for SaaS: Affitor, Rewardful, FirstPromoter, Dub Partners, and PartnerStack. Pricing checked October 2026, the 2% payout-fee nuance, attribution trade-offs, and a straight answer on who should pick what."
+metaDescription: "Five honest Tolt alternatives for SaaS: Affitor ($0 until $10K), Rewardful, FirstPromoter, Dub and PartnerStack. Tolt's 2% payout fee and who should pick what."
date: "2026-07-05"
updated: "2026-11-12"
category: Comparison
diff --git a/content/blog/tolt-vs-rewardful.mdx b/content/blog/tolt-vs-rewardful.mdx
index b4d3e79c..e1dfd9ab 100644
--- a/content/blog/tolt-vs-rewardful.mdx
+++ b/content/blog/tolt-vs-rewardful.mdx
@@ -1,6 +1,7 @@
---
title: "Tolt vs Rewardful: Which Is Best for SaaS in 2026?"
description: "Rewardful starts $50 lower; Tolt gives a third more headroom at $99 and automates global payouts. Both publish an API. Every number checked against both pricing pages in October 2026 (Tolt re-checked November 12, 2026), plus Affitor, the $0/month option neither compare page mentions."
+metaDescription: "Rewardful vs Tolt: which is best for SaaS? Rewardful starts $50 lower; Tolt gives a third more headroom at $99 and automates payouts. Affitor is $0 until $10K."
date: '2026-07-05'
updated: '2026-11-12'
category: Comparison
diff --git a/scripts/check-agent-surface.mjs b/scripts/check-agent-surface.mjs
index 25cbee62..4040755e 100644
--- a/scripts/check-agent-surface.mjs
+++ b/scripts/check-agent-surface.mjs
@@ -206,6 +206,7 @@ function inventory() {
sourceDate: data.updated ?? data.date,
body: markdown(data, id),
date: data.date, category: data.category, title: data.title, description: data.description,
+ metaDescription: data.metaDescription,
};
});
return [...docs, blogIndexInventory(posts), ...posts, ...changelogInventory()];
@@ -230,6 +231,25 @@ function blogIndexInventory(posts) {
}
/** The built /blog page: the twin link, and one CollectionPage whose ItemList is the twin's list, in order. */
+/**
+ * CORE-1010 P1.2: a post's search snippet may differ from its dek. The prerendered page carries
+ * metaDescription (or description) in , and still shows description as the dek.
+ */
+function checkBlogMeta(posts) {
+ for (const post of posts) {
+ const route = `/${post.id}`;
+ const html = read(join(APP, `${post.id}.html`));
+ const metas = [...html.matchAll(/]*\bname="description"[^>]*>/g)].map((m) => m[0]);
+ assert.equal(metas.length, 1, `${route}: expected one meta description`);
+ const content = decodeEntities(metas[0].match(/\bcontent="([^"]*)"/)[1]);
+ const expected = post.metaDescription ?? post.description;
+ assert.equal(content, expected, `${route}: meta description`);
+ if (post.metaDescription !== undefined) assert.ok(post.metaDescription.length <= 160, `${route}: metaDescription over 160`);
+ assert.ok(decodeEntities(html).includes(post.description), `${route}: the dek under the H1 must stay description`);
+ }
+ return posts.filter((post) => post.metaDescription !== undefined).length;
+}
+
function checkBlogIndexHtml(index) {
const html = read(join(APP, 'blog.html'));
const links = [...html.matchAll(/]*>/g)].map((match) => match[0])
@@ -562,6 +582,8 @@ function main() {
console.log(`PASS tracking contract: ${contract.statements} window statements, ${contract.pins} pinned statements, ${contract.examples} sale examples carry their idempotency key; ${contract.checked} contract rules checked in the docs, ${contract.outside} outside the docs`);
const openApiPaths = checkOpenApi();
const pages = inventory();
+ const separateMeta = checkBlogMeta(pages.filter((page) => page.type === 'blog' && page.id.startsWith('blog/')));
+ console.log(`PASS blog meta: ${separateMeta} posts carry their own search snippet; every dek stays description`);
const ids = pages.map((page) => page.id);
assert.equal(new Set(ids).size, ids.length, 'Duplicate source page ids');
const manifest = json(join(ROOT, '.next/prerender-manifest.json'));
diff --git a/source.config.ts b/source.config.ts
index 82f15a30..06e409ec 100644
--- a/source.config.ts
+++ b/source.config.ts
@@ -101,6 +101,9 @@ export const blog = defineCollections({
schema: frontmatterSchema.extend({
// description doubles as the one-line dek + machine summary — required for blog
description: z.string(),
+ // Search snippet only (meta, og, twitter, JSON-LD). The dek under the H1, the /blog card and the
+ // .md twin keep `description`. Falls back to `description` when absent.
+ metaDescription: z.string().max(160).optional(),
date: z.string(),
category: z.string(),
authors: z.array(z.string()),
diff --git a/src/app/blog/[slug]/page.tsx b/src/app/blog/[slug]/page.tsx
index 0ce34789..833a54f5 100644
--- a/src/app/blog/[slug]/page.tsx
+++ b/src/app/blog/[slug]/page.tsx
@@ -55,7 +55,7 @@ function buildJsonLd(post: Post, slug: string) {
graph.push({
'@type': 'BlogPosting',
headline: post.title,
- description: post.description,
+ description: post.metaDescription ?? post.description,
datePublished: post.date,
dateModified,
url,
@@ -110,7 +110,7 @@ function buildJsonLd(post: Post, slug: string) {
graph.push({
'@type': 'HowTo',
name: post.title,
- description: post.description,
+ description: post.metaDescription ?? post.description,
step: steps.map((item, i) => ({
'@type': 'HowToStep',
position: i + 1,
@@ -147,7 +147,7 @@ export async function generateMetadata(props: {
return {
// absolute: the blog lives on affitor.com, so no "| Affitor Docs" suffix.
title: { absolute: `${post.title} | Affitor` },
- description: post.description,
+ description: post.metaDescription ?? post.description,
alternates: {
// Canonical home of every post is the proxied affitor.com/blog zone.
canonical: `${BLOG_URL}/${slug}`,
@@ -156,7 +156,7 @@ export async function generateMetadata(props: {
},
openGraph: {
title: post.title,
- description: post.description,
+ description: post.metaDescription ?? post.description,
type: 'article',
url: `${BLOG_URL}/${slug}`,
publishedTime: post.date,
@@ -166,7 +166,7 @@ export async function generateMetadata(props: {
twitter: {
card: 'summary_large_image',
title: post.title,
- description: post.description,
+ description: post.metaDescription ?? post.description,
},
};
}