Configuring Projects

This guide covers how to configure your BetterPost project settings. For a step-by-step tutorial on creating your first project, see Your First Project.

Project Settings Page

The project settings page allows you to configure the basic settings for your BetterPost project. All changes are saved automatically as you type.

Basic Settings

Project Name

• The display name for your project
• This appears throughout the interface and in generated content
• Changes are saved automatically as you type

Default Target Audience

• Describe who your content is intended for
• This setting applies to all channels by default
• Can be overridden at the channel level
• Use a multi-line description to be specific about your audience

Default Tone

• Define the writing style and voice for your content
• Examples: "professional", "casual", "informative", "conversational"
• This setting applies to all channels by default
• Can be overridden at the channel level

Advanced Settings

Additional Instructions

• Customize content generation with specific guidelines
• Applied to all channels by default (can be overridden per channel)
• Examples: "Add lots of emoji", "Use bullet points frequently", "Keep sentences short"
• Advanced feature for fine-tuning AI output beyond audience and tone
• Word limits: Configurable content length (50-10,000 words, default varies by channel type)

Max Story Age (Days)

• Maximum age in days for stories to be included in your project
• Stories older than this setting are automatically filtered out
• Range: 1-30 days (default: 14 days)
• Affects story discovery, content generation, and scheduled posts
• When increased, previously excluded stories may be queued for summarization

Content Criteria

Criteria

• Define what type of content should be included in your project
• Enter one criterion per line in the large text area
• Each line becomes a separate criterion used for content matching
• The AI uses these criteria to evaluate and score potential content

Example criteria:

artificial intelligence
machine learning developments
startup funding news
product launch announcements
technology industry trends

Import from URL

The "Import from URL..." feature allows you to automatically configure your project based on an existing publication:

1. Click the "Import from URL..." button
2. Enter the URL of a publication's website or example article
3. The AI analyzes the content and automatically sets:
   • Project name
   • Default audience
   • Default tone
   • Content criteria

Warning: This will completely overwrite your current project settings. The action cannot be undone.

Content Types Tab

Configure platform-specific settings for different content types:

Available Content Types:

• Newsletter
• Blog Post
• Email Outreach
• X (Twitter)
• LinkedIn
• Facebook
• BlueSky
• TikTok
• Instagram
• YouTube Shorts

Settings Per Content Type:

• Additional Instructions - Override default additional instructions for this specific content type
• Word Limits - Set target word counts (50-10,000 words)
  • Blog posts: Default 800 words, recommended 500-2,000 for SEO
  • Other content types: Varies by platform requirements
• Settings are automatically saved and applied during content generation
• If no content type settings are configured, project defaults are used

Saved Topics Tab

Manage a library of topics for quick reference during content creation:

• Add Topics - Create new topics that appear in Advanced Mode content generation
• Edit Topics - Update existing topics as your focus areas evolve
• Delete Topics - Remove topics that are no longer relevant
• Topics can be referenced when creating custom scheduled posts or in Advanced Mode

Product Tie-Ins Tab

Manage product or service descriptions that can be woven into generated content:

• Add Tie-Ins - Create new product/service descriptions with title and description
• Edit Tie-Ins - Update titles and descriptions as your offerings change
• Import from URL - Automatically extract product information from a webpage
• Delete Tie-Ins - Remove tie-ins that are no longer active
• Tie-ins can be selected during content generation and scheduled posts
• Useful for: Product announcements, service highlights, business outreach content

Delete Project

At the bottom of the page, you can permanently delete the project:

• Click "Delete Project..."
• Confirm in the dialog that appears
• This permanently deletes the project and all associated channels, sources, and stories
• This action cannot be undone

How Auto-Save Works

All text fields on the project settings page use auto-save:

• Changes are saved automatically after you stop typing
• You'll see a spinning loader icon next to "Project Settings" while saving
• No need to click a "Save" button
• If there's an error saving, you'll see a notification

Best Practices

Writing Effective Criteria

• Be specific rather than general
• Use concrete topics rather than vague concepts
• Include industry-specific terms when relevant
• Start with 5-10 criteria and refine based on results

Setting Your Audience

• Be specific about who you're targeting
• Include relevant details like industry, role, or interests
• Consider the level of technical knowledge
• Think about what information they need

Choosing Your Tone

• Match your audience's expectations
• Consider your brand voice
• Be consistent across all content
• Test different tones to see what works

Using Additional Instructions

• Keep instructions clear and specific
• Focus on style and format preferences
• Avoid conflicting instructions
• Test with content generation to see the impact

Good Additional Instructions Examples:

Add lots of emoji to make content more engaging
Use bullet points and numbered lists for clarity
Include technical jargon appropriate for developers
Keep sentences short and punchy
Focus on actionable insights and takeaways

Avoid:

Be funny but professional (conflicting)
Write like a famous author (too vague)
Use complex language (unclear)

Story Summarization

BetterPost automatically summarizes stories to improve relevancy scoring and content generation:

• Automatic Summarization - Stories are summarized when fetched from sources (either immediately if content is available, or queued for async processing)
• Summary Updates - When you increase max story age, previously excluded stories that don't have summaries may be queued for summarization
• Relevancy Scoring - Summaries are used to calculate how well stories match your content criteria
• Content Generation - Summaries help AI understand story context for better content creation

Next Steps

After configuring your project:

• Add content sources to feed your project
• Set up scheduled posts for automated content generation
• Explore source types to understand different content options