# Classifieds

> The space where members post ads for jobs, services or items for sale and other members show interest. Categories, term, images, optional approval, who sees the interested people and what the platform does not do.

The **Classifieds** module gives structure to the informal exchange between members: an open job, a service on offer, something for sale. Each ad has a category, a term and, if the community wants it, a value; it disappears on its own when the term ends; and whoever is interested leaves a message that only the advertiser and the team read.

**The platform does not intermediate sales, payments or negotiations.** The value of an ad is information only: there is no checkout, fee or charge. The conversation and the agreement happen outside Memberfy, between the people involved, through each person's account contact.

## What it's for

| Community | Classifieds |
|---|---|
| Condominium or neighborhood | Who sells a bicycle, who recommends an electrician |
| Professional association | Open jobs and services offered among members |
| School or class | Used materials, rides, tutoring |
| Coworking | Desk openings, residents' services |

## How it works

### Who does what

| Role | What they do |
|---|---|
| **Owner and admin** | Create the space and set categories, terms, value and approval (**Space settings**). Approve, reject and remove any ad, and see the interested people of any ad. They can also post |
| **Moderator and finance** | Are part of the team: see the interested people of any ad and change the status of each, approve and reject in the **Under review** queue, and remove any ad. They do not configure the space. Posting depends on the space's **Who can post** |
| **Member** | Browses, posts (if the space allows), shows interest, edits and deletes their **own** ads and sees the interests they sent |
| **Visitor or no access to the space** | Does not see the ads: visibility is the space's |

Who can post follows the space's rule, the **Who can post** field, as in the other modules.

### The ad

| Field | What it's for |
|---|---|
| **Title** | Up to 140 characters |
| **Category** | One of the space's categories |
| **Description** | Formatted text |
| **Images (optional)** | Up to **6** per ad, JPEG, PNG or WebP, up to 20 MB each. The first is the **Cover** |
| **Term** | How long the ad stays up, among the space's options. It cannot be changed after publishing |
| **Value (optional)** and **Note on the value** | Only appear if the space shows value. It is information ("per hour", "negotiable"), in the community's currency |

There is no limit on how many ads a person can post.

An ad has one of these statuses: **Active**, **Under review**, **Rejected** or **Expired**.

### Categories and terms

A new Classifieds space comes with the categories **Jobs**, **Services** and **For sale** (in the community's language) and the terms **7, 15 and 30 days**. The owner or admin can rename, reorder, add and remove categories (a category with ads is not removed: move or delete the ads first) and choose other terms, from 1 to 365 days. **Show value** starts on.

### Approval (optional)

By default the ad goes live at once. With **Require approval** on, a new ad stays **Under review** until the team decides.

- **The term counts from the first approval**, not from creation. Until then the card shows *"After approval"*. Approving again later does not renew the term.
- Changing the title, description or images of an approved ad sends it back to review. The term keeps running.
- If the team rejects it, the reason goes by email to whoever posted. The author can adjust the ad, and it goes back to review.

### Interest

On an active ad, anyone who is not the author clicks **I'm interested**, writes a message (up to 2,000 characters) and clicks **Send interest**.

- **Before sending**, the person sees what will be shown and to whom: the ad's author and the team (owner, admins, moderators and finance) see the **name**, the **message** and the **email and phone registered on the account**. Nobody else. The conversation continues outside the platform.
- Each person has **one interest per ad** and cannot show interest in their own ad. There is a limit of 20 interests per hour.
- An ad under review, rejected or expired does not receive interest.
- **My interests** holds the ones the person sent. **Withdraw interest** takes the message out of the advertiser's and the team's view, and the person can send another later.

### Who is interested

On the ad, the **Interested people** section (for the author and the team) lists each person with name, photo, profile link, message, the account's email and phone, and the date. Each interest has the status **New**, **Seen** or **Answered**, changed with **Mark as seen** and **Mark as answered**.

### When the term ends

The ad leaves the public list and the author gets an email. They still see the ad and the interested people in **My ads**, and can delete it. There is no renewal: to continue, post a new ad.

### Deleting

The author deletes their own ad whenever they want, and the team removes any ad. Deleting removes the ad for everyone, **along with the images and the list of interested people**, and cannot be undone.

### Emails

| When | Email | To whom |
|---|---|---|
| Someone shows interest | New interest, with a notice and the **See interested people** button. The contact is **not** in the email: it stays inside the platform | The ad's author |
| The term ends | The ad has expired | The author |
| The team decides (only with approval on) | Ad approved or rejected, the latter with the reason | The author |

The person who shows interest gets no email: the screen already answers. There is no notice before the term ends.

## Step by step

### Create the space

*Role: owner or admin.*

1. Under the section, **Add Space**.
2. Choose the **Classifieds** module and click **Next**.
3. **Icon**, **Title**, **Slug**, **Description**, **Visibility** and **Who can post**, as in any space. **Next** takes you to the **Classifieds** step.
4. In the **Classifieds** step, review the **Categories** (the suggestions can be edited), the **Allowed terms**, **Show value** and **Require approval**. All of this can be changed later in **Space settings**.
5. **Create Space**.

If the rules fail to save after creation, the space already exists and the dialog says so.

### Post an ad

*Role: whoever can post in the space.*

1. In the space, click **New ad**.
2. Fill in **Title**, **Category**, **Description**, the images, the **Term** and, if there is one, the **Value**.
3. Click **Publish ad**. Without prior approval it goes live; with approval, it stays **Under review**.

If the ad is saved but the images fail, the screen offers **Send images again** or **Close without images**.

### Show interest

1. Open the ad and click **I'm interested**.
2. Write the message, read the **What will be shown** notice and click **Send interest**.

### Follow the interested people

*Role: the author, or the team.*

1. In **My ads**, open the ad (the team opens any ad from the list).
2. In **Interested people**, read the messages and the account contact.
3. Mark each as **seen** or **answered**.

### Approve or reject

*Role: owner, admin, moderator or finance.*

1. Open the **Under review** tab (only the team sees it; the **Manage classifieds** bar shows how many are waiting).
2. On each ad, **Approve**, or **Reject** and give the **Reason** in **Reject ad**: the reason goes by email to the author.

Ads under review also appear in the general [Moderation](/membros/moderacao) queue.

### Delete an ad

Open the ad and use **Delete** in the **Manage ad** bar, then confirm in **Delete ad**.

## What does not exist yet

Renewing the term, marking as "sold" or "closed", highlighting an ad, reporting, replying inside the platform and an in-app notice do not exist yet.

## Examples

**An association of engineers.** An **Opportunities** space with the categories *Jobs* and *Services*, terms of 15 and 30 days, value off and approval on. Each job goes through the moderator before going live.

**A condominium.** A **Neighborhood classifieds** space with the default categories and approval off. A resident posts *"29-inch bicycle"* for 7 days; a neighbor clicks **I'm interested**; the advertiser gets the email, opens **Interested people** and answers on the account's phone.

## Common errors and how to fix them

| Situation | What to do |
|---|---|
| **New ad** does not appear | The space limits who posts: check **Who can post** |
| **I'm interested** does not appear | The ad is yours, is not active, or you already sent interest |
| The ad does not show in the list | It is **Under review**, was rejected or expired: only the author and the team see it |
| The category cannot be removed | It has ads: move or delete the ads first |
| The **Value** field does not appear | **Show value** is off in the space |

## Frequently asked questions

**Does Memberfy charge any fee on what is advertised?**
No. There is no checkout or charge: the value of an ad is information only.

**Who sees my email and phone?**
Only the author of the ad you showed interest in and the community team (owner, admins, moderators and finance). The notice email to the advertiser does not carry your contact.

**Can I change an ad's term?**
No. The term is chosen when posting. For a different term, delete and post again.

## In the API

`GET` and `PUT /api/classifieds/spaces/{spaceId}` (space settings), `GET` and `POST /api/classifieds/ads`, `GET`, `PUT` and `DELETE /api/classifieds/ads/{id}`, `POST` and `GET /api/classifieds/ads/{id}/interests`, `PUT /api/classifieds/ads/{id}/interests/{interestId}`, `GET /api/classifieds/interests/mine`, `DELETE /api/classifieds/ads/{id}/interests/mine`, the images at `/api/upload/classifieds/ads/{adId}/images` and the queue at `/api/moderation/classifieds`. The reference for each route enters the [API reference](/api/referencia) page when the module is live.

## Related

- [Create and organize spaces](/espacos/criar-e-organizar-espacos)
- [Moderation](/membros/moderacao)
- [Modules](/conceitos/modulos)