# Content Planner

{% hint style="info" %}
**Pro Tip: We always recommend having human eyes pass through generate articles before LIVE publishing on your or your client's websites.** 
{% endhint %}

## Content Planner

Content Planner is your central hub for scheduling and managing all content—articles, social posts, local SEO pages, and newsletters. See everything in a calendar or list view, and let automation handle the heavy lifting.

> **Doc paths:** The automation-focused guide is `Content Planner & Automation`. This page is an alternate entry; we keep both URLs for legacy links.

***

### Overview

Content Planner unifies your content calendar:

| Content Type     | Description                                 |
| ---------------- | ------------------------------------------- |
| **Articles**     | SEO blog posts from keyword clusters        |
| **Social Posts** | Auto-generated posts for multiple platforms |
| **Local SEO**    | Location-based service pages                |
| **Newsletters**  | Weekly content digests (coming soon)        |

***

### Calendar Views

#### Calendar View

Visual month/week calendar showing:

* Scheduled content by date
* Color-coded by content type
* Drag-and-drop rescheduling
* Weekend toggle (show/hide)

#### List View

Chronological list of all content:

* Sortable columns
* Bulk actions
* Filtering by type and status

***

### How Content Flows In

#### From Content Clusters

When you mark a cluster as "In Plan":

1. Keywords are queued for content
2. Click **Refresh** in Content Planner
3. Articles are scheduled based on your default frequency
4. Social posts auto-generated (if enabled)

#### Manual Scheduling

Add content directly:

1. Click any date in calendar view
2. Choose content type
3. Enter details and schedule

***

### Social Post Automation

The killer feature—automatic social posts when articles publish.

#### How It Works

1. Article publishes
2. Cuppa generates social posts using your Brand DNA:
   * Brand voice
   * Company values
   * ICP (Ideal Customer Profile)
   * Key differentiators
3. Posts scheduled per your offset (e.g., 2 hours after publish)
4. Optional AI-generated images using brand colors

#### Supported Platforms

| Platform        | Character Limit | Images |
| --------------- | --------------- | ------ |
| Twitter/X       | 280             | ✅      |
| LinkedIn        | 3,000           | ✅      |
| Facebook        | 63,206          | ✅      |
| Instagram       | 2,200           | ✅      |
| TikTok          | 2,200           | ✅      |
| YouTube         | 5,000           | ✅      |
| Pinterest       | 500             | ✅      |
| Reddit          | 40,000          | ✅      |
| Bluesky         | 300             | ✅      |
| Threads         | 500             | ✅      |
| Google Business | 1,500           | ✅      |
| Telegram        | 4,096           | ✅      |
| Snapchat        | Varies          | ✅      |

#### Platform-Specific Content

Each platform gets tailored content:

* **LinkedIn:** Professional, thought-leadership angle
* **Twitter/X:** Punchy, hook-driven, thread-ready
* **Instagram:** Visual-first, hashtag optimized
* **Facebook:** Engaging, shareable, community-focused

***

### Configuration

#### Auto-Social Settings

Navigate to **Content Planner → Settings**:

| Setting                 | Description                                 |
| ----------------------- | ------------------------------------------- |
| **Auto-Social Toggle**  | Enable/disable automatic post generation    |
| **Default Platforms**   | Which platforms to create posts for         |
| **Schedule Offset**     | Delay after article publish (minutes/hours) |
| **Generate Images**     | Create AI images for posts                  |
| **Hashtag Preferences** | Include/exclude hashtags, count             |
| **Brand Context**       | Which brand profile to use                  |

#### Scheduling Preferences

| Setting            | Options                        |
| ------------------ | ------------------------------ |
| **Default Time**   | When to schedule new content   |
| **Frequency**      | Daily, 2x weekly, weekly, etc. |
| **Avoid Weekends** | Skip Saturday/Sunday           |
| **Timezone**       | Your local timezone            |

***

### Working with the Planner

#### Refresh Content

Click **Refresh** to:

* Pull in new content from "In Plan" clusters
* Schedule pending items
* Update status of existing items

#### Rescheduling

**Drag and drop:** Click and drag any item to a new date.

**Edit details:** Click an item to modify date, time, or content.

#### Bulk Actions

Select multiple items to:

* Move to a new date
* Change status
* Delete
* Generate content now

#### Status Workflow

| Status          | Description                         |
| --------------- | ----------------------------------- |
| **Scheduled**   | Queued for the specified date       |
| **In Progress** | Currently being generated           |
| **Ready**       | Content generated, awaiting publish |
| **Published**   | Live on your CMS/platforms          |
| **Failed**      | Error occurred (check logs)         |

***

### Social Post Publishing

#### Using Late.dev Integration

Cuppa integrates with Late.dev for publishing:

1. Connect your social accounts in Late.dev
2. Link Late.dev to Cuppa
3. Posts auto-publish or queue for review

#### Manual Publishing

Without integration:

1. Generate social posts in Content Planner
2. Copy content from each post
3. Paste into native platform interfaces

***

### Cost Considerations

Social post generation uses your API keys (BYOK):

| Component        | API                         | Est. Cost     |
| ---------------- | --------------------------- | ------------- |
| Text Generation  | OpenAI (GPT-4o-mini)        | \~$0.01/post  |
| Image Generation | Replicate (Nano Banana Pro) | \~$0.05/image |

**Example:** 4 platforms × 1 post + 4 images = \~$0.24 per article

***

### Troubleshooting

#### "Refresh not finding new content"

**Check:**

* Clusters are marked "In Plan"
* Site/brand is selected
* Keywords exist in clusters

#### "Social posts not generating"

**Check:**

* Auto-Social is enabled in settings
* Default platforms are selected
* OpenAI API key is configured
* Brand context exists

#### "Images not included"

**Check:**

* Image generation is enabled
* Replicate API key is configured
* Brand visual style is set up

#### "Wrong brand voice in posts"

**Solution:** Ensure the correct brand context and voice are selected in Content Planner settings.

***

### Best Practices

#### Content Cadence

**For most businesses:**

* 2-3 articles per week
* Social posts with each article
* Batch generation weekly

**For aggressive SEO:**

* Daily articles
* Multiple social variations per article
* Automated cross-posting

#### Calendar Organization

* Color-code by content type
* Use status consistently
* Review weekly to catch gaps
* Plan 30-60 days ahead

#### Social Timing

Optimal posting varies by platform:

| Platform  | Best Times             |
| --------- | ---------------------- |
| LinkedIn  | Tue-Thu, 7-8am or 12pm |
| Twitter/X | Mon-Fri, 8am-4pm       |
| Instagram | Tue-Fri, 11am or 7-8pm |
| Facebook  | Wed, 11am or 1pm       |

***

***

### Related Features

* Content Clusters — Feed content into the planner
* Keyword Imports — Source keywords for clusters
* Brand Voice — Voice for social posts


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://learn.cuppa.ai/automations/content-planner.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.