Skip to main content

Creating and Managing Listings

Learn how to create professional property listings with photos, detailed information, and all the features buyers and renters need to make informed decisions.

Getting Started

To create property listings, you need admin access. Once authenticated, you can access the property management tools.
1

Access Admin Panel

Navigate to the Admin Panel by clicking “Panel de Administración” in the navigation menu.
2

Click Add Property

Click the “Agregar Propiedad” button in the top-right corner of the admin panel.
3

Fill Out Property Form

Complete all required fields in the property form, organized into logical sections.
4

Upload Images

Add high-quality photos of the property and arrange them in the desired order.
5

Review and Submit

Review all information and click “Guardar” to publish your listing.

Basic Information

The first section captures essential property details.

Required Fields

title
string
required
Property Title - Create a compelling, descriptive titleExamples:
  • “Casa 3 Dormitorios con Jardín - Barrio Cerrado”
  • “Departamento 2 Ambientes Luminoso - Centro”
  • “Terreno 500m² - Zona Residencial”
description
string
required
Description - Provide a detailed description of the propertyInclude:
  • Key features and highlights
  • Condition and recent updates
  • Neighborhood information
  • Nearby amenities (schools, shopping, transport)
propertyType
select
required
Property Type - Select from available options loaded from the databaseOptions include: Casa, Departamento, PH, Terreno, Local, Galpón, Oficina, Campo, Depósito, Bodega, Consultorio, Fondo de comercio, Hotel, Cochera
propertySubtype
select
Property Subtype - Optional, appears after selecting property typeSubtypes are dynamically loaded based on the selected property type for more specific categorization.
operationType
select
required
Operation Type - How the property will be transactedOptions: Venta, Alquiler, Alquiler Temporal, Permuta
status
select
required
Status - Current listing statusOptions:
  • Activo: Publicly visible and active
  • Pendiente: Not yet published
  • Reservado: Reserved by a potential buyer
  • Vendido: Sold (archived)
  • Alquilado: Rented (archived)
  • Pausado: Temporarily hidden from public view
Set status to “Pendiente” while preparing the listing, then change to “Activo” when ready to publish.

Pricing Information

price
number
required
Price - The current asking price
  • Automatically formatted with thousands separator (e.g., 150.000)
  • Must be greater than 0
  • Used for search filtering and sorting
currency
select
required
Currency - Price currencyOptions: ARS (Pesos Argentinos), USD (US Dollars), EUR (Euros)
originalPrice
number
Original Price - If the property has been discountedWhen set higher than current price:
  • Displays a strikethrough original price
  • Shows discount percentage badge
  • Highlights the deal to potential buyers
expenses
number
Monthly Expenses - Condominium fees, HOA dues, etc.Important for renters and buyers to calculate total monthly costs.
If you’re editing a property and change the price, the system automatically saves the previous price as “originalPrice” to show price history.

Property Specifications

Provide detailed measurements and features.

Surface Areas

  • Covered Surface (m²): Interior living space
  • Uncovered Surface (m²): Exterior areas like terraces, balconies
  • Lot Size (m²): Total land area (for houses/land)

Room Configuration

  • Rooms: Total number of rooms
  • Bedrooms: Number of bedrooms
  • Bathrooms: Number of bathrooms
  • Garage Spaces: Parking spots included

Additional Details

  • Year Built: Construction year
  • Condition: Excellent, Very Good, Good, To Renovate, Under Construction
  • Floor: Floor number (for apartments)
Accurate specifications are crucial for search filters. Double-check all measurements before publishing.

Features and Amenities

Pre-defined Features (Checkboxes)

Select all that apply: Standard Amenities:
  • Balcón (Balcony)
  • Terraza (Terrace)
  • Lavadero (Laundry room)
  • Jardín (Garden)
  • Acepta mascotas (Pets allowed)
Special Features:
  • Oportunidad (Great opportunity)
  • Crédito Hipotecario (Mortgage available)
  • Apto profesional (Suitable for professional use)
  • Acepta permuta (Accepts trade-in)
  • Amoblado (Furnished)
  • Dueño directo (Direct from owner)

Custom Characteristics

Add unlimited custom features:
  1. Type a feature in the “Características adicionales” field
  2. Press Enter or comma to add it
  3. Remove by clicking the X on the feature badge
  4. Maximum 150 characters per feature
Custom features appear alongside pre-defined ones on the property detail page. Use them for unique amenities like “Piscina climatizada” or “Sistema de seguridad”.

Location Information

Accurate location details help buyers find your property.

Address Fields

street
string
required
Street Name - Main street address
streetNumber
string
Street Number - Building/house number
floorApartment
string
Floor/Apartment - Unit identifier (e.g., “3° A”, “PB 2”)
neighborhood
string
Neighborhood - Local neighborhood or area name
city
string
required
City - City name
province
string
required
Province - State or province
postalCode
string
Postal Code - ZIP or postal code

Address Autocomplete

Use the address autocomplete feature (AddressAutocomplete component) to:
  • Automatically fill in address fields
  • Get accurate coordinates for the map
  • Ensure consistent formatting

Map Pin Adjustment

After entering the address:
  1. Click “Mostrar mapa” to display the interactive map
  2. Drag the red pin to the exact property location
  3. Fine-tune coordinates for accurate positioning
  4. The map updates the latitude/longitude automatically
Coordinates are used to display the property on map-based searches and in the property detail page map.

Image Management

High-quality images are essential for attracting potential buyers.

Adding Images

1

Click 'Agregar Imágenes'

Open the file picker to select images from your device.
2

Select Photos

Choose multiple images at once (max 20 new images per upload).Requirements:
  • Format: JPG, PNG, WebP
  • Max size: 20MB per file
  • Recommended: High resolution, well-lit photos
3

Preview and Arrange

Images appear as thumbnails that you can drag to reorder.
4

Set Main Image

Click the star icon on the image that should be the property’s primary photo.

Image Operations

Reordering Images:
  • Drag and drop images to rearrange (uses @dnd-kit/core)
  • First image is automatically the main image
  • Order determines gallery display sequence
Rotating Images:
  • Click the rotate icon to rotate 90° clockwise
  • Rotation state is saved and applied when the property is saved
  • Available for both new and existing images
Setting Main Image:
  • Click the star icon on any image
  • Main image appears in property cards and search results
  • Can be different from the first image in the gallery
Deleting Images:
  • Click the trash icon on existing images to mark for deletion
  • Marked images show a red overlay until saved
  • Changes are applied when you save the property
Always include at least one high-quality image. Properties without images perform poorly in search results and get fewer inquiries.

Image Best Practices

  1. Use Professional Photos: Well-lit, high-resolution images
  2. Show Key Areas: Living room, bedrooms, kitchen, bathrooms, exterior
  3. Highlight Features: Pool, garden, views, unique amenities
  4. Correct Order: Start with the most impressive photo
  5. Consistent Lighting: Avoid mixing day and night photos

YouTube Virtual Tour

Add a virtual tour or property video:
youtubeVideoUrl
string
YouTube Video URL - Full URL to a YouTube videoExample: https://www.youtube.com/watch?v=VIDEO_IDThe video will be embedded on the property detail page for immersive viewing.
Virtual tours significantly increase engagement. Consider creating a walkthrough video or 360° tour.

Saving Your Listing

Before Saving

Verify all required fields are complete:
  • ✅ Title and description
  • ✅ Property and operation type
  • ✅ Price and currency
  • ✅ Location (street, city, province)
  • ✅ At least one image
  • ✅ Status is set correctly

Validation Errors

If required fields are missing, you’ll see:
  • Red borders around incomplete fields
  • Error messages below each field
  • A summary error at the top of the form

Success

After successful save:
  • Green success message appears
  • You’re redirected to the Admin Panel
  • The property appears in your listings
  • If status is “Activo”, it’s immediately visible to the public
Changes to existing properties are reflected immediately. There’s no approval process for edits.

Editing Existing Listings

From the Admin Panel:
  1. Find the property you want to edit
  2. Click the blue Edit icon (pencil)
  3. Modify any fields as needed
  4. Manage existing images (delete, reorder, rotate)
  5. Add new images if needed
  6. Click “Guardar” to save changes

Editing Images

When editing:
  • Existing images appear with metadata (order, main status)
  • Mark images for deletion with the trash icon
  • Reorder by dragging
  • Add new images alongside existing ones
  • Set a different main image

Price Updates

When changing the price:
  • The previous price is automatically saved as “originalPrice”
  • Creates a discount display if new price is lower
  • Price history helps buyers see value

Common Tasks

  1. Set Operation Type to “Venta”
  2. Enter the sale price in appropriate currency
  3. Include all property specifications
  4. Add high-quality photos of all areas
  5. Set status to “Activo” when ready
  1. Set Operation Type to “Alquiler”
  2. Enter monthly rent price
  3. Add monthly expenses in the expenses field
  4. Include rental terms in description
  5. Specify if furnished (Amoblado checkbox)
  6. Note if pets are allowed
  1. Edit the property
  2. Change status from “Activo” to “Reservado”
  3. Save changes
  4. Property remains visible but shows “Reservado” badge
  1. Edit the property
  2. Change status to “Pausado”
  3. Save changes
  4. Property is removed from public listings
  5. Change back to “Activo” to republish
  1. Edit the property
  2. Enter the original price in “Original Price” field
  3. Update “Price” to the discounted amount
  4. Save changes
  5. Property displays with discount percentage badge

Troubleshooting

Check:
  • File size is under 20MB per image
  • File format is JPG, PNG, or WebP
  • You’re not exceeding 20 images per upload
  • Browser has stable internet connection
Verify:
  • All required fields are filled (marked with *)
  • Price is greater than 0
  • At least one image is uploaded
  • No red validation errors are showing
Solutions:
  • Use the address autocomplete feature
  • Manually drag the map pin to correct location
  • Ensure street address is complete and accurate

Build docs developers (and LLMs) love