Home › Library › Property Photos & Videos

Property Photos & Videos

Upload property photos and add YouTube videos to showcase your rental properties

Overview

The Property Media module allows you to upload photos and add YouTube videos to create visual galleries for your rental properties. Photos are stored securely in the cloud, while videos are embedded from YouTube.

Photo Upload

Upload interior and exterior photos (JPG, PNG, WEBP, max 10 MB)

YouTube Videos

Embed YouTube videos by URL for property tours and walkthroughs

Filtering & Search

Filter media by type (interior/exterior) and upload date range

Interactive Gallery

View photos in lightbox with zoom and navigation controls

Media Types

The system supports the following media document types:

Code Name Description
PHOTO_INTERIOR Interior Photo Interior photos (rooms, living spaces, kitchen, bathrooms)
PHOTO_EXTERIOR Exterior Photo Exterior photos (building facade, yard, parking, surroundings)
VIDEO_INTERIOR Interior Video Interior video tours (YouTube embedded)
VIDEO_EXTERIOR Exterior Video Exterior video tours (YouTube embedded)
PHOTO_OTHER Other Photos Other photos not categorized as interior or exterior

Workflow

Typical workflow for managing property media:

1

Open Media Gallery

Navigate to property page and click "Photo / Video" in the property menu

2

Add Media

Click "Add" button to open the upload form

3

Choose Type

Select document type (interior/exterior photo or video)

4

Upload or Link

For photos: select file (JPG/PNG/WEBP, max 10 MB). For videos: paste YouTube URL

Technical Details

Photo Requirements

  • Supported formats: JPG, PNG, WEBP
  • Maximum file size: 10 MB
  • Storage: secure cloud storage
  • Access: Secure URLs with HMAC signatures

Video Requirements

  • Platform: YouTube only
  • Supported URL formats:
    • https://www.youtube.com/watch?v=VIDEO_ID
    • https://youtu.be/VIDEO_ID
  • Videos are embedded via iframe (no storage on your server)

Permissions

Access rights for property media:

Role View Add Delete
Landlord Yes Yes Yes
Landlord Agent Yes Yes Yes
Tenant Yes No No
Tenant Agent Yes No No
Maintenance Staff Yes No No

REST API

Property media uses the general Document API with specific document types. All endpoints require JWT authentication.

Photo Operations

POST   /api/v1/properties/{id}/documents                - Upload photo
GET    /api/v1/properties/{id}/documents?type_id={type} - List media by type
DELETE /api/v1/properties/{id}/documents/{doc_id}     - Delete media

Document Type IDs

Use the following document type codes when uploading:

PHOTO_INTERIOR  - Interior photos (rooms, living spaces, kitchen, bathrooms)
PHOTO_EXTERIOR  - Exterior photos (building facade, yard, parking, surroundings)
VIDEO_INTERIOR  - Interior video tours (YouTube embedded)
VIDEO_EXTERIOR  - Exterior video tours (YouTube embedded)
PHOTO_OTHER     - Other photos not categorized as interior or exterior

Example: Upload Interior Photo

POST /api/v1/properties/123/documents
Content-Type: multipart/form-data
Authorization: Bearer YOUR_JWT_TOKEN

{
    "document_type_code": "PHOTO_INTERIOR",
    "file": [binary file data],
    "comment": "Living room with new furniture"
}

Example: Add YouTube Video

POST /api/v1/properties/123/documents
Content-Type: application/json
Authorization: Bearer YOUR_JWT_TOKEN

{
    "document_type_code": "VIDEO_INTERIOR",
    "youtube_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "comment": "Full apartment tour 2026"
}

Example: Filter by Type

GET /api/v1/properties/123/documents?type_id=5
Authorization: Bearer YOUR_JWT_TOKEN

Response:
{
    "total": 15,
    "items": [
        {
            "id": 45,
            "document_type": {
                "id": 5,
                "code": "PHOTO_INTERIOR",
                "name": "Interior Photo"
            },
            "url": "/file/cG1mOjQ1OjA6ZWEyNTYuLi4",
            "comment": "Living room",
            "uploaded_at": "2026-02-03T14:30:00+00:00"
        }
    ]
}

Interactive API Documentation

For complete interactive API documentation with request/response examples, visit:

Open Swagger UI →

Best Practices

Tips for Great Property Photos

  • Use good lighting - natural daylight is best
  • Clean and declutter spaces before photographing
  • Show all important features: kitchen, bathroom, storage
  • Include exterior shots: building, parking, yard, neighborhood
  • Use wide angles to show full room layout
  • Take photos from corners to maximize visible space
  • Add videos for virtual tours (more engaging for tenants)

Related Topics