> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gridix.live/llms.txt
> Use this file to discover all available pages before exploring further.

# Apartment Management

> Configure and manage apartments in your real estate projects

Apartments are the core units of your projects. This guide covers how to add, edit, and manage apartment properties in Gridix.

## Apartment Properties

Each apartment in Gridix can have the following properties:

<CardGroup cols={2}>
  <Card title="Basic Information">
    * Apartment number
    * Floor number
    * Number of rooms
    * Area (square meters)
  </Card>

  <Card title="Pricing & Status">
    * Price
    * Status (available, sold, reserved, etc.)
    * Discount (if applicable)
    * Featured status
  </Card>
</CardGroup>

## Adding Apartments

### From Floor Plan

<Steps>
  <Step title="Open Floor Plan">
    Navigate to your project and open a floor plan in the editor.
  </Step>

  <Step title="Mark Apartment Location">
    Click on the floor plan where you want to place an apartment.
  </Step>

  <Step title="Enter Apartment Number">
    Enter the apartment number (e.g., 101, 102, A-1).
  </Step>

  <Step title="Set Basic Properties">
    Configure:

    * Number of rooms
    * Area in square meters
    * Initial price
    * Status
  </Step>

  <Step title="Save Apartment">
    Click "Save" to create the apartment. It will appear on the floor plan.
  </Step>
</Steps>

### From Apartment List

<Steps>
  <Step title="Go to Apartments List">
    Navigate to "Apartments" section in project editor.
  </Step>

  <Step title="Click Add Apartment">
    Click the "+ Add Apartment" button.
  </Step>

  <Step title="Fill Apartment Details">
    Enter all required information in the form.
  </Step>

  <Step title="Assign to Floor Plan">
    Optionally assign the apartment to a specific location on a floor plan.
  </Step>
</Steps>

## Editing Apartments

### Single Apartment Edit

<Steps>
  <Step title="Select Apartment">
    Click on an apartment in the floor plan or apartment list.
  </Step>

  <Step title="Open Edit Mode">
    Click "Edit" or double-click the apartment.
  </Step>

  <Step title="Modify Properties">
    Update any apartment properties:

    * Change number of rooms
    * Update area
    * Modify price
    * Change status
    * Update custom fields
  </Step>

  <Step title="Save Changes">
    Click "Save" to apply changes.
  </Step>
</Steps>

### Bulk Editing

Edit multiple apartments at once:

<Steps>
  <Step title="Select Apartments">
    Use checkboxes or filters to select multiple apartments.
  </Step>

  <Step title="Choose Bulk Action">
    Select from available bulk actions:

    * Update status
    * Change price
    * Modify custom fields
    * Delete apartments
  </Step>

  <Step title="Apply Changes">
    Enter new values and confirm the bulk action.
  </Step>
</Steps>

## Apartment Status

### Available Statuses

Apartments can have the following statuses:

* **Available**: Ready for sale, visible to customers
* **Sold**: Already sold, not available
* **Reserved**: Temporarily reserved, pending sale
* **Hidden**: Not visible to customers (for maintenance, etc.)

<Info>
  Status colors are customizable in project visualization settings. This helps customers quickly identify available apartments.
</Info>

### Status Management

<Steps>
  <Step title="Select Apartment">
    Choose the apartment you want to update.
  </Step>

  <Step title="Change Status">
    Select new status from dropdown menu.
  </Step>

  <Step title="Add Note (Optional)">
    Add a note explaining the status change (e.g., "Reserved until payment").
  </Step>

  <Step title="Save Status">
    Changes are saved automatically and reflected immediately.
  </Step>
</Steps>

## Custom Fields

### Adding Custom Fields

Customize apartments with additional properties:

<Steps>
  <Step title="Go to Fields Configuration">
    Navigate to Project Settings → Custom Fields.
  </Step>

  <Step title="Add New Field">
    Click "Add Field" and configure:

    * Field name
    * Field type (text, number, date, boolean, select)
    * Default value
    * Required status
  </Step>

  <Step title="Apply to Apartments">
    The field becomes available for all apartments in the project.
  </Step>
</Steps>

### Field Types

* **Text**: Single or multi-line text
* **Number**: Numeric values with decimals
* **Date**: Date picker
* **Boolean**: Yes/No checkbox
* **Select**: Dropdown with predefined options
* **Multi-select**: Multiple selections allowed

## Pricing

### Setting Prices

<Steps>
  <Step title="Select Apartment">
    Choose the apartment you want to price.
  </Step>

  <Step title="Enter Price">
    Enter the price in the project's currency.
  </Step>

  <Step title="Apply Discount (Optional)">
    Set discount percentage or fixed amount.
  </Step>

  <Step title="Save Price">
    Price is saved and displayed in the widget.
  </Step>
</Steps>

### Price Formats

Prices are displayed according to:

* Project currency setting
* Currency symbol position
* Decimal places
* Thousands separator

## Apartment Images

### Adding Images

<Steps>
  <Step title="Select Apartment">
    Open apartment details.
  </Step>

  <Step title="Upload Images">
    Click "Add Images" and select:

    * Interior photos
    * Views from windows
    * Floor plan details
    * 3D visualizations
  </Step>

  <Step title="Set Primary Image">
    Choose one image as the primary display image.
  </Step>

  <Step title="Reorder Images">
    Drag and drop to reorder image gallery.
  </Step>
</Steps>

### Image Requirements

* **Format**: JPG, PNG, WebP
* **Size**: Recommended 1920x1080 or higher
* **File Size**: Max 5MB per image
* **Aspect Ratio**: 16:9 recommended for best display

## Favorites and Notes

### Marking Favorites

Customers can mark apartments as favorites. View favorite statistics:

* Most favorited apartments
* Popular apartment types
* Customer preferences

### Internal Notes

Add internal notes for team members:

<Steps>
  <Step title="Open Apartment">
    Select apartment from list or floor plan.
  </Step>

  <Step title="Add Note">
    Click "Add Note" and enter:

    * Note text
    * Note type (internal, customer, etc.)
    * Visibility settings
  </Step>
</Steps>

<Note>
  Internal notes are only visible to team members, not customers.
</Note>

## Search and Filtering

### Finding Apartments

Use search and filters to find apartments:

* **Search by Number**: Enter apartment number
* **Filter by Status**: Show only available, sold, etc.
* **Filter by Price Range**: Set min/max price
* **Filter by Rooms**: Show specific room counts
* **Filter by Area**: Set area range

### Advanced Filters

* Floor number
* Custom field values
* Date created/modified
* Price range
* Status combinations

## Exporting Apartment Data

<Steps>
  <Step title="Select Apartments">
    Choose apartments to export (or select all).
  </Step>

  <Step title="Choose Export Format">
    Select export format:

    * Excel (.xlsx)
    * CSV
    * JSON
  </Step>

  <Step title="Select Fields">
    Choose which fields to include in export.
  </Step>

  <Step title="Download Export">
    Click "Export" to download the file.
  </Step>
</Steps>

## Best Practices

<Tip>
  **Consistent Numbering**: Use consistent apartment numbering (101, 102, 201, 202) for easy navigation.
</Tip>

<Tip>
  **Accurate Pricing**: Keep prices updated regularly to avoid customer confusion.
</Tip>

<Tip>
  **Status Updates**: Update apartment status promptly when sales occur.
</Tip>

<Tip>
  **High-Quality Images**: Use professional photos to showcase apartments effectively.
</Tip>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Apartment not appearing on floor plan">
    * Verify apartment is assigned to correct floor
    * Check floor plan coordinates
    * Ensure apartment is not hidden
    * Refresh browser cache
  </Accordion>

  <Accordion title="Can't edit apartment">
    * Verify edit permissions
    * Check if apartment is locked
    * Ensure project is not archived
    * Try refreshing the page
  </Accordion>

  <Accordion title="Price not displaying correctly">
    * Check currency settings
    * Verify price format configuration
    * Ensure currency is set for project
    * Check for formatting errors
  </Accordion>
</AccordionGroup>

## Next Steps

* **[Project Editing](/en/projects/editing)** - Learn about editing project settings
* **[Visualization Setup](/en/projects/visualization)** - Customize apartment display
* **[Pricing Configuration](/en/projects/pricing)** - Set up pricing and installments