# Content

> A space for posts and articles in text, image or video, with a cover, tags, a page of their own, comments and reactions. Who publishes, how to format, image limits and how to import from Substack.

The **Content** module is the place for texts that stay: articles, guides, tutorials, long announcements, posts with photos or video. Each item has its own page, with comments and reactions, and also shows up in the [Feed](/espacos/feed) of whoever can see it.

## What it's for

| Community | Content space |
|---|---|
| Online school | **Materials**: summaries and exercises for each lesson |
| Coworking | **House guide**: rules, Wi-Fi, how to book a room |
| Company HR | **Announcements**, posted only by the staff |
| Content creator | A public **Blog** that works as a showcase |

## How it works

### The three types

| Type | For | What you fill in |
|---|---|---|
| **Text** | Ideas, tips, articles | The title and the text, with the editor (bold, italics, lists and links) |
| **Image** | Photos, screenshots, infographics | Up to **4 images** (JPG, PNG or GIF, up to **5 MB** each) and the caption |
| **Video** | Videos from YouTube, Vimeo and others | The video link and the description |

All of them accept **Tags** (optional) and a **Cover Image** (optional, 16:9, 2000×1125 px recommended).

### The list and the page

The list shows the items with reading time, views and likes, with filters (**All**, **Articles**, **Guides**, **Tutorials**). Each item's page has the full text, reactions and comments.

### Who can do what

| Action | Who |
|---|---|
| Create | Members and above, according to the space's **Who can post** |
| Edit and delete your own | The author |
| Edit and delete someone else's | Moderator, admin and owner |
| Comment and react | Whoever sees the space |

## Step by step

### Publish

*Role: whoever the space lets post.*

1. Open the space and click **Create Content**.
2. Choose the **Content type**: **Text**, **Image** or **Video**.
3. Fill in the **Title** and the content (the text, the images with the caption, or the **Video URL** with the description).
4. If you like, **Tags** (Enter, comma or space adds them) and the **Cover Image**.
5. **Publish**.

### Edit or delete

In the item's menu, **Edit content** (*"Make the necessary changes to your content."*) or **Delete content**. Deleting removes the text and the media.

## Examples

**An open blog that turns into sign-ups.** A **Blog** space (Public, **Admins**) in a public section. Visitors read; to comment, they need to sign in, and open sign-up does the rest.

**Company announcements.** An **Announcements** space (Members, **Staff**). Everyone reads and comments; only HR and leadership post.

**Course materials.** A **Materials** space in the **Student area** (Private, by plan). Each lesson gets a post with the summary and the links.

## Importing from Substack

If you already publish on Substack, you can bring the posts into a Content space through the API: `POST /api/import/substack`, owner and admin only. See [Import](/api/referencia/import).

## Common errors and how to fix them

| Message | What to do |
|---|---|
| The **Create Content** button doesn't appear | The space is set to **Staff** or **Admins** |
| Image rejected | Use JPG, PNG or GIF up to 5 MB, 4 at most |
| *Content not found* | The item was deleted, or you don't have access to the space |

## Frequently asked questions

**Can I schedule a post?**
There's no scheduling.

**Is the video hosted in the community?**
The video plays from its link (YouTube, Vimeo and others).

**Can I attach a PDF?**
There are no file attachments; put the file's link in the text.

## In the API

`GET /api/content`, `POST /api/content` (`spaceId`, `title`, `type`), `PUT /api/content/{id}`, `PUT /api/content/{id}/move` (moves the post to another Content or Feed space, moderator and up), `POST /api/content/{id}/comment`, `POST /api/upload/content/image`. See [Content](/api/referencia/content).

## Related

- [Feed](/espacos/feed)
- [Spaces](/conceitos/espacos)
- [Moderation](/membros/moderacao)
