Knowledge Base SEO and Sharing

How to get there: Click Boards in the sidebar → select your Knowledge Base board. SEO settings are configured per article.

Learn how to optimize your ProductLift knowledge base for search engines, improve discoverability, customize sharing metadata, and drive more traffic to your help documentation.

Why SEO Matters for Knowledge Bases

Benefits of SEO-Optimized Documentation:

Search Engine Visibility:

  • Users find answers via Google search
  • Reduce support ticket volume
  • Drive organic traffic to your product
  • Build authority in your niche

User Experience:

  • Fast-loading, accessible content
  • Mobile-friendly documentation
  • Clear navigation and structure
  • Easy sharing on social media

Business Impact:

  • Lower support costs (self-service)
  • Better onboarding experience
  • Increased product awareness
  • Higher customer satisfaction

[Screenshot: Google search results showing ProductLift knowledge base article ranked #1 for relevant query]

SEO Fundamentals

How Search Engines Index Knowledge Bases

Indexing Process:

  1. Crawling: Search engine bots visit your knowledge base
  2. Parsing: Bot reads HTML content and metadata
  3. Indexing: Content added to search engine index
  4. Ranking: Algorithm determines search ranking

ProductLift Knowledge Base:

  • Public by Default: Articles visible to search engines
  • Clean URLs: SEO-friendly article URLs
  • Structured Data: Schema markup included automatically
  • Sitemap: XML sitemap generated automatically
  • Fast Loading: Optimized for Core Web Vitals

[Screenshot: Diagram showing search bot crawling knowledge base, parsing content, and indexing]

SEO Factors That Matter

Content Quality:

  • Comprehensive answers to user questions
  • Original, valuable content
  • Regular updates and freshness

Technical SEO:

  • Page speed and performance
  • Mobile responsiveness
  • HTTPS security
  • Proper HTML structure

On-Page SEO:

  • Title tags and meta descriptions
  • Header hierarchy (H1, H2, H3)
  • Internal linking
  • Image alt text

Off-Page SEO:

  • External links to your articles
  • Social shares
  • Brand mentions
  • Domain authority

Optimizing Article Content

Article Titles

Title Tag = SEO Gold:

The article title becomes the HTML <title> tag, crucial for SEO.

Best Practices:

Be Descriptive:

  • ❌ "Installation"
  • ✅ "How to Install ProductLift Widget in 5 Minutes"

Include Keywords:

  • What would users search for?
  • Example: "Dark Mode Setup" → "How to Enable Dark Mode in Your Portal"

Keep it Concise:

  • Target: 50-60 characters
  • Google truncates after ~60 characters
  • Front-load important keywords

Be Unique:

  • Each article needs unique title
  • Avoid duplicate titles

[Screenshot: Article editor showing title field with character count and SEO preview]

Examples:

Good SEO Titles:
- "Getting Started with ProductLift: Complete Setup Guide"
- "User Segments Explained: Filter by MRR, Plan Type, and More"
- "How to Integrate ProductLift with Slack (Step-by-Step)"
- "Troubleshooting Common Installation Issues"

Bad SEO Titles:
- "Setup" (too vague)
- "Article 1" (meaningless)
- "Everything You Ever Wanted to Know About Setting Up ProductLift For Your SaaS Application With All The Details" (too long)

Meta Descriptions

What is Meta Description:

Short summary (150-160 characters) shown in search results below title.

Setting Meta Description:

Article Editor → SEO Settings → Meta Description

Best Practices:

Compelling Summary:

  • Summarize article in 1-2 sentences
  • Include target keyword
  • Call-to-action when appropriate

Optimal Length:

  • 150-160 characters
  • Google truncates longer descriptions

Include Value Proposition:

  • What will user learn?
  • Why read this article?

[Screenshot: Article SEO settings showing meta description field with character counter]

Examples:

Good Meta Descriptions:
"Learn how to install the ProductLift feedback widget on your website in under 5 minutes. Step-by-step guide with code examples for React, Vue, and vanilla JavaScript."

"Segment your users by MRR, plan type, and behavior to prioritize high-value customer feedback. Complete guide with examples and best practices."

Bad Meta Descriptions:
"This article explains things." (vague)
"Installation installation installation installation..." (keyword stuffing)

Header Structure

Proper Header Hierarchy:

Use headers to structure content logically:

# Article Title (H1 - Only One Per Article)

## Main Section (H2)

### Subsection (H3)

#### Detail (H4)

## Another Main Section (H2)

### Subsection (H3)

Why It Matters:

  • Search engines use headers to understand content structure
  • Users scan headers to find information
  • Accessibility (screen readers navigate by headers)

Best Practices:

  • One H1 per article (the title)
  • Descriptive headers (not "Section 1")
  • Include keywords naturally
  • Logical hierarchy (don't skip levels)

[Screenshot: Article outline showing proper header hierarchy with nested structure]

Keyword Optimization

Target Keywords:

Identify what users search for:

Keyword Research:

  • Google Search Console (what brings traffic)
  • Customer support tickets (common questions)
  • Forum discussions
  • Competitor documentation

Keyword Placement:

Include target keyword in:

  • Article title (H1)
  • URL slug
  • First paragraph
  • Subheaders (H2, H3)
  • Throughout content (naturally)
  • Image alt text

Avoid Keyword Stuffing:

  • ❌ "ProductLift ProductLift ProductLift widget widget..."
  • ✅ Natural language with keywords incorporated

[Screenshot: Keyword density checker showing recommended keyword usage percentage]

Content Length

Comprehensive > Brief:

Guidelines:

  • Minimum: 300 words
  • Ideal: 800-1,500 words for main topics
  • Longer for comprehensive guides (2,000+ words)

Why Longer Content Ranks:

  • More comprehensive answers
  • More opportunities for keywords
  • More internal links
  • Higher user engagement (time on page)

Quality Over Quantity:

  • Don't add fluff to hit word count
  • Be thorough but concise
  • Break long articles into sections
  • Use bullet points and lists

Internal Linking

Link Between Articles:

Benefits:

  • Helps search engines discover content
  • Distributes "link equity" across site
  • Improves user navigation
  • Increases time on site

Best Practices:

Link Contextually:

Learn more about [user segments](/f/knowledgebase/user-segments) in our detailed guide.

Descriptive Anchor Text:

  • ❌ "Click here"
  • ✅ "user segments guide"

Link to Related Content:

  • 3-5 internal links per article
  • Link to both parent and child topics
  • Link to related topics

[Screenshot: Article showing multiple internal links with hover tooltips displaying link destinations]

Images and Media

Optimize Images:

Alt Text:

  • Describe image content
  • Include keywords when relevant
  • Help search engines understand images
  • Critical for accessibility

![ProductLift dashboard showing analytics metrics with monthly active users graph](dashboard-analytics.png)

Image Size:

  • Compress images (use WebP format)
  • Target: < 200 KB per image
  • ProductLift auto-optimizes uploaded images

File Names:

  • Descriptive file names
  • ❌ IMG_1234.png
  • ✅ productlift-dashboard-analytics.png

Technical SEO Configuration

Custom URLs

SEO-Friendly URLs:

ProductLift generates URLs from article titles:

Article Title: "How to Install ProductLift Widget"
URL: /kb/how-to-install-productlift-widget

Customize URL Slug:

Article Editor → SEO Settings → Custom URL Slug

Best Practices:

  • Keep URLs short and readable
  • Use hyphens (not underscores)
  • Include primary keyword
  • All lowercase
  • No special characters

[Screenshot: Custom URL slug input field showing slug being edited with preview URL]

Canonical URLs

What is Canonical URL:

Tells search engines which version of duplicate content is primary.

When to Use:

  • Multiple URLs lead to same content
  • Syndicated content
  • Preventing duplicate content issues

ProductLift Default:

Canonical tag automatically points to article's primary URL.

Custom Canonical:

If content appears elsewhere:

Article Editor → SEO Settings → Canonical URL

Enter the original/primary URL.

[Screenshot: Canonical URL field with example external URL entered]

Open Graph Tags

What are Open Graph Tags:

Metadata for social media sharing (Facebook, LinkedIn, etc.).

Automatic Tags:

ProductLift automatically generates:

  • og:title - Article title
  • og:description - Meta description
  • og:image - Article featured image
  • og:url - Article URL
  • og:type - "article"

Custom Social Images:

Upload custom image for social sharing:

Article Editor → SEO Settings → Social Sharing Image

Image Specifications:

  • Size: 1200 x 630 px (recommended)
  • Format: JPG or PNG
  • File size: < 1 MB

[Screenshot: Social preview showing how article appears when shared on Facebook/Twitter with custom image]

Twitter Cards

Enhanced Twitter Sharing:

ProductLift includes Twitter Card metadata:

Automatic Tags:

  • twitter:card - "summary_large_image"
  • twitter:title - Article title
  • twitter:description - Meta description
  • twitter:image - Social sharing image

Preview:

Test how article appears on Twitter:

  • Use Twitter Card Validator
  • https://cards-dev.twitter.com/validator

[Screenshot: Twitter card preview showing article thumbnail and description]

Schema Markup

Structured Data:

ProductLift automatically adds JSON-LD schema markup:

Article Schema:

{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "How to Install ProductLift Widget",
  "author": {
    "@type": "Organization",
    "name": "ProductLift"
  },
  "datePublished": "2026-01-15",
  "dateModified": "2026-01-20"
}

Benefits:

  • Rich snippets in search results
  • Better search engine understanding
  • Potential for featured snippets

[Screenshot: Google rich snippet showing article with published date and author information]

Sitemap and Indexing

XML Sitemap

Automatic Sitemap Generation:

ProductLift generates XML sitemap automatically:

https://yourportal.productlift.com/sitemap.xml

What's Included:

  • All public knowledge base articles
  • Last modified dates
  • Change frequency hints
  • Priority values

Submit to Search Engines:

Google Search Console:

  1. Go to https://search.google.com/search-console
  2. Add your property (yourportal.productlift.com)
  3. Submit sitemap URL
  4. Monitor indexing status

Bing Webmaster Tools:

  • Same process for Bing

[Screenshot: Google Search Console sitemap submission showing successful submission with indexed pages count]

Robots.txt

Search Engine Instructions:

ProductLift's robots.txt allows crawling:

User-agent: *
Allow: /kb/
Disallow: /admin/
Sitemap: https://yourportal.productlift.com/sitemap.xml

Customize (Enterprise):

Settings → SEO → Robots.txt

Add custom rules if needed.

Noindex Articles

Prevent Specific Articles from Indexing:

Article Editor → SEO Settings → Search Engine Visibility

Options:

  • Index (Default): Allow search engines
  • Noindex: Hide from search engines

When to Noindex:

  • Draft articles
  • Outdated content (deprecated features)
  • Internal documentation
  • Duplicate content

[Screenshot: Search engine visibility toggle showing "Index" selected]

Performance and Core Web Vitals

Page Speed Optimization

Why Speed Matters:

  • Google ranking factor
  • User experience
  • Mobile users (slower connections)
  • Reduced bounce rates

ProductLift Optimizations:

  • CDN: Content delivered from edge locations
  • Image Optimization: Automatic WebP conversion
  • Code Minification: CSS/JS minified
  • Lazy Loading: Images load as user scrolls
  • Caching: Aggressive browser and server caching

Measure Performance:

  • Google PageSpeed Insights
  • https://pagespeed.web.dev/
  • Target: >90 score

[Screenshot: Google PageSpeed Insights showing high scores for mobile and desktop]

Mobile Optimization

Mobile-First Indexing:

Google primarily uses mobile version for indexing and ranking.

ProductLift Mobile Features:

  • Responsive design (adapts to screen size)
  • Touch-friendly navigation
  • Fast mobile loading
  • No horizontal scrolling
  • Readable font sizes

Test Mobile:

  • Google Mobile-Friendly Test
  • https://search.google.com/test/mobile-friendly

[Screenshot: Mobile-friendly test showing "Page is mobile-friendly" result]

Analytics and Monitoring

Search Console Integration

Connect Google Search Console:

Settings → SEO → Google Search Console

Link Your Property:

  1. Verify domain ownership
  2. ProductLift fetches search data
  3. View search analytics in ProductLift

Metrics Available:

  • Search queries (what users search)
  • Impressions (how often article appears in results)
  • Clicks (how many users click)
  • Average position in search results
  • Click-through rate (CTR)

[Screenshot: Search Console dashboard showing top queries, impressions, clicks, and average position]

Track SEO Performance

Key Metrics:

Organic Traffic:

  • Users from search engines
  • Track via Google Analytics
  • Monitor trends over time

Keyword Rankings:

  • Track positions for target keywords
  • Use rank tracking tools
  • Monitor improvements

Engagement Metrics:

  • Time on page
  • Bounce rate
  • Pages per session

[Screenshot: Analytics dashboard showing organic traffic trend line graph over 6 months]

Top Performing Articles

Identify Winners:

Review your knowledge base article performance from the knowledge base section in the admin interface.

Sort by:

  • Most views
  • Highest search traffic
  • Best engagement

Optimize Top Articles:

  • Update content regularly
  • Add more internal links
  • Improve related articles
  • Expand comprehensive coverage

[Screenshot: Top articles list showing view counts and traffic sources]

Social Sharing Optimization

Social Sharing Buttons

Enable Sharing:

Article footer includes share buttons for:

  • Twitter
  • Facebook
  • LinkedIn
  • Email
  • Copy link

Configuration:

Settings → Knowledge Base → Social Sharing

Options:

  • Enable/disable specific networks
  • Customize share text
  • Add hashtags

[Screenshot: Article with social sharing buttons at bottom]

Pre-Populated Share Text

Custom Share Messages:

Article Editor → SEO Settings → Social Share Text

Example:

Twitter Share Text:
"How to install the ProductLift widget in 5 minutes 🚀"

LinkedIn Share Text:
"Comprehensive guide to integrating ProductLift with your SaaS application"

Use Cases:

  • Add relevant hashtags
  • Call-to-action
  • Mention your brand handle

Track Social Shares

Monitor Sharing:

Track social sharing through your external analytics tools or the knowledge base section in the admin interface.

Metrics:

  • Share count per network
  • Most shared articles
  • Share trends over time

International SEO

Multi-Language Support

Translate Knowledge Base:

Settings → Knowledge Base → Languages

Add Languages:

  • Enable additional languages
  • Articles can be translated
  • Language selector in navigation
  • Hreflang tags added automatically

SEO Benefits:

  • Reach international audience
  • Rank in multiple languages
  • Better user experience for non-English speakers

[Screenshot: Language selector showing English, Spanish, French, German options]

Hreflang Tags

Automatic Implementation:

ProductLift adds hreflang tags when multiple languages enabled:

<link rel="alternate" hreflang="en" href="https://portal.com/kb/article" />
<link rel="alternate" hreflang="es" href="https://portal.com/es/kb/article" />
<link rel="alternate" hreflang="fr" href="https://portal.com/fr/kb/article" />

Benefits:

  • Tells search engines which language version to show
  • Prevents duplicate content issues
  • Improves international SEO

Best Practices

Regular Content Updates

Keep Content Fresh:

  • Update articles quarterly
  • Add new information
  • Remove outdated content
  • Search engines favor fresh content

Update Dates:

ProductLift shows "Last updated" date:

  • Updates automatically on edit
  • Signals freshness to users and search engines

Create Content Clusters:

Hub and Spoke Model:

Main Topic: "ProductLift Setup" (Hub)
  ├─ Installation Guide (Spoke)
  ├─ Widget Configuration (Spoke)
  ├─ Branding Customization (Spoke)
  └─ First Post Creation (Spoke)

Cross-Link Related Articles:

  • Each spoke links to hub
  • Spokes link to related spokes
  • Hub links to all spokes

SEO Benefit:

  • Establishes topic authority
  • Distributes link equity
  • Improves crawlability

[Screenshot: Content cluster diagram showing hub article surrounded by related spoke articles with connecting lines]

Answer User Questions

Question-Based Titles:

Users search with questions:

Good Question Titles:
- "How Do I Install the ProductLift Widget?"
- "What is the Difference Between Segments and Groups?"
- "Why Aren't My Emails Being Delivered?"

Featured Snippet Optimization:

  • Start with concise answer (40-60 words)
  • Then expand with details
  • Use lists and tables
  • Include "how to" steps

Example Structure:

# How Do I Install the ProductLift Widget?

To install the ProductLift widget, paste the provided script tag before the closing </body> tag in your HTML. The widget appears in the bottom-right corner and collects feedback from your users.

## Step-by-Step Installation

1. Copy widget code from Settings → Widgets
2. Paste before </body> tag
3. Save and deploy
4. Test widget on your site

[Detailed instructions follow...]

[Screenshot: Google featured snippet showing ProductLift article answer at top of search results]

Monitor and Iterate

Monthly SEO Review:

  1. Check Google Search Console
  2. Identify low-performing articles
  3. Update content, improve titles/meta
  4. Add internal links
  5. Monitor improvements

Experiment:

  • A/B test title variations
  • Try different meta descriptions
  • Add/remove content sections
  • Measure impact on traffic

Troubleshooting

Issue: Articles Not Appearing in Search

Solution:

  • Check article is published (not draft)
  • Verify "Index" setting enabled (not noindexed)
  • Submit sitemap to Google Search Console
  • Wait 1-2 weeks for indexing
  • Check robots.txt not blocking

Issue: Low Search Rankings

Solution:

  • Improve content quality and depth
  • Add internal links from other articles
  • Optimize title and meta description
  • Increase page speed
  • Build external backlinks

Issue: High Bounce Rate

Solution:

  • Improve content quality (answer user question)
  • Add related articles links
  • Improve page speed
  • Ensure mobile-friendly
  • Clear navigation

Issue: Social Shares Not Working

Solution:

  • Check Open Graph tags present (view page source)
  • Verify social sharing image uploaded
  • Test with Facebook Debugger / Twitter Card Validator
  • Clear social media cache

Knowledge Base Setup:

Configuration:

Analytics: