# Gallery

> The community's image space, with uploads of up to 50 images at once, a title, description, tags, views and reactions. Who uploads, who moderates and the file limits.

The **Gallery** brings images together: event photos, members' work, behind the scenes, a class portfolio. Each image has a title, description, tags, views and reactions.

## What it's for

| Community | Gallery |
|---|---|
| Coworking | Photos from the house's events |
| Design school | Students' work, for feedback |
| Company HR | The end-of-year party album |
| Event | The official photos, after the event |

## How it works

### Uploading

Up to **50 images** at once, up to **100 MB** each. Each one gets a **Title**, **Description** and **Tags**.

### Browsing

Filter by **All Images** or **My Images** and sort by **Most Recent**, **Most Liked** or **Most Viewed**. The list loads more with the button at the bottom.

### Who can do what

| Action | Who |
|---|---|
| Upload | Members and above, according to the space's **Who can post** |
| Edit and delete your own | Whoever uploaded them |
| Edit and delete other people's | Moderator, admin and owner |
| React | Whoever sees the space |

## Step by step

### Upload images

*Role: whoever the space lets post.*

1. In the space, **Upload Image**.
2. **Click to select images** (up to 50).
3. Fill in **Title**, **Description** and **Tags**.
4. **Upload**.

### Edit or delete

On the image card, **Edit** (**Edit Image**) or **Delete** (*"Are you sure you want to delete this image? This action cannot be undone."*).

## Examples

**The event's official album.** A **Photos 2027** space (Members, **Staff**): only the staff uploads; everyone reacts.

**The class portfolio.** A **Projects** space (Private, the class group, **Anyone**): each student uploads their own.

## Good practices

- **One Gallery space per subject** (one per event, one per class) makes photos easy to find.
- **Use tags** for who appears or for the topic: filtering by tag helps later.
- **Titles that tell the story**: "Conference opening, room 1" says more than "IMG_0231".
- **Ask permission** before publishing photos of people, especially in public spaces.
- **Upload photos already resized**: 2000 px on the longest side is enough for the screen and loads fast.

## Common errors and how to fix them

| Message | What to do |
|---|---|
| *Maximum 50 images allowed per upload* | Upload in more than one batch |
| *File exceeds 100MB limit* | Make the image smaller |
| A member doesn't see **Upload Image** | The space is set to **Staff** or **Admins** |

## Frequently asked questions

**Does the gallery accept video?**
It's for images. Videos go in Content spaces.

**Can people download the images?**
The image is shown large on its page; downloading is up to the browser.

## In the API

`POST /api/upload/gallery/images` (multipart), `GET /api/gallery/images`, `PUT /api/gallery/images/{imageId}`, `DELETE /api/gallery/images/{imageId}`, `POST /api/gallery/images/{imageId}/react`. See [Gallery](/api/referencia/gallery).

## Related

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