Published on September 30, 2025

AtlasKB — Getting Started with Product Pages (Example Article)

Article ID: KB-0007

 Product: AtlasKB (Knowledge Base for SaaS Teams)

 Last updated: September 29, 2025

 Author: AtlasKB Docs Team

 Tags: onboarding, product-pages, content-templates, search


TL;DR

This article shows how to create a clear, searchable Product Page in AtlasKB — the canonical article type you’ll use to publish product features, release notes, and how-tos. Use the templates and search hints below to make pages discoverable and easy for customers or internal users to follow.


What is a Product Page?

A Product Page in AtlasKB is a structured knowledge article designed to explain a product feature or flow end-to-end. It includes:

  1. A short summary for search results
  2. Step-by-step instructions
  3. Quick troubleshooting tips
  4. One or more code or API examples (optional)
  5. Related resources and changelog entries

Product Pages are the recommended article type for onboarding users to a new feature or documenting supported integrations.


When to use a Product Page

  1. You’ve launched a new feature (e.g., “Smart Retry for Failed Payments”) and need a single-page reference for customers and support.
  2. You want to replace a multi-email onboarding sequence with a self-serve guide.
  3. You need a repeatable template for multiple product lines or modules.


Quick-start template (copy/paste)

Title: [Feature name] — Quick Start
 Summary: One-sentence summary for search and previews.
 Prerequisites: List any account/plan requirements.
 Steps: Numbered setup steps with screenshots or GIFs.
 FAQ: Short answers to top customer questions.
 Troubleshooting: 3 common issues + fixes.
 Related articles: Links to API docs, pricing, and release notes.
 Changelog: Versions and short notes.


Example: "Smart Retry — Quick Start"

Summary: Set up Smart Retry to automatically recover failed card payments and reduce churn by retrying on optimal days.

Prerequisites

  1. AtlasKB account with Admin role
  2. Billing plan: Pro or higher
  3. Stripe connected (Stripe keys required)

Setup steps

  1. Go to Product → Billing → Smart Retry.
  2. Click Enable Smart Retry.
  3. Select retry strategy:
  4. Aggressive — retries on days 1, 3, 7 (higher recovery, more dunning emails)
  5. Balanced — retries on days 3, 7, 14 (recommended)
  6. Conservative — retries on days 7, 14, 30 (fewer retries, gentler customer experience)
  7. Configure communication templates:
  8. Click Email templates → edit the 3 reminder templates (use {{customer_first_name}}, {{order_number}} tokens)
  9. Set webhook for payment failures: copy webhook URL from Integrations → Webhooks and add it to Stripe’s Dashboard.
  10. Click Save & Test — AtlasKB will simulate a failed payment and show expected behavior.
Tip: Use the Preview toggle to view how each template renders for a sample customer.

Expected behavior

  1. On a simulated failure, AtlasKB will schedule retry attempts according to the strategy and send email reminders 24 hours before retry attempts if enabled.


API example (cURL)

Use the API to create a Smart Retry policy programmatically:


curl -X POST "https://api.atlaskb.example.com/v1/retries" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Balanced - ecommerce",
"strategy": [3,7,14],
"notify_before_retry": true,
"email_template_id": "tmpl_6a2F"
}'

Response (200):


{
"id": "retry_01GZ",
"name": "Balanced - ecommerce",
"strategy": [3,7,14],
"status": "active"
}


Troubleshooting

Problem: Smart Retry isn't scheduling retries.

 Fix: Confirm your Stripe webhook is verified (check the webhook logs in AtlasKB). If the webhook signature fails, re-add the webhook secret.

Problem: Customers report duplicate reminder emails.

 Fix: Check for multiple active retry policies applied to the same billing group. Disable one policy or merge templates.

Problem: Test simulation shows “no action taken.”

 Fix: Ensure the test customer has a failed payment status in Stripe and that the payment method is retriable (some gateway declines are non-retriable).


Best practices for Product Pages

  1. Keep the summary under 140 characters — it appears in search results.
  2. Use at least one screenshot or GIF for UI flows.
  3. Add keywords metadata: include synonyms and common misspellings (e.g., smart-retry, dunning, retry-failed-payments).
  4. Add troubleshooting steps directly in the article — customers search queries like “retry not working” should return this article.


Search optimization tips

  1. Use descriptive headings (e.g., “Enable Smart Retry” instead of “Step 1”).
  2. Add an FAQ section with short Q/A pairs; AtlasKB surfaces these as quick answers.
  3. Tag the page with product names and integrations (e.g., Stripe, Payments, Dunning).
  4. For video or GIF assets, include an accessible text transcript under the media.


Related articles

  1. API: Webhooks & Events — KB-0012
  2. Email Template Tokens — KB-0003
  3. Billing Plans & Feature Matrix — KB-0001


Changelog

  1. 2025-09-29 (v1.2) — Added cURL API example and troubleshooting item for duplicate emails.
  2. 2025-06-10 (v1.1) — Small wording updates; added search tips.


FAQ (short)

Q: Does Smart Retry work with other gateways besides Stripe?

 A: Currently Smart Retry is supported for Stripe and Adyen. Support for Braintree is coming Q4 2025.

Q: Can I customize the retry schedule per customer segment?

 A: Yes — use Segmented Policies under Billing → Policies to attach schedules to cohorts.

Write Your Comment