3.4 Units

The Units section of the admin panel provides an overview and management interface for all tokenized real estate properties available on the platform — these are the investment units that users can browse, explore in detail, and purchase tokens of through the published smart contracts.

3.4.1 List of Units

Each entry in this list represents a tokenized real estate property available for investment now or in the future, and the section gives admins the tools to review unit details, track token distribution, monitor transaction history, and manage publication status where necessary.

3.4.1.1 Search & Filtering

In the Units section, administrators can quickly locate specific properties using the search and filtering tools located at the top of the list.

• Global Search Bar: search across all units using unit name, slug, or location.
• Column Filters: each table column supports its own filter or input field to narrow down results:
  • Unit – dropdown with predefined unit titles.
  • Slug – free text input for URL slugs.
  • Type – dropdown with unit types. There are currently three of them:
    • Residential
    • Land
    • Commercial
  • Location – free text input to filter by asset location.
  • Status – dropdown filter for statuses like Published, Archived, or Not published.
• Reset All Filters: clicking this button clears all applied filters and restores the full unit list.

These tools help administrators manage large volumes of units more effectively by surfacing only relevant entries based on custom criteria.

3.4.1.2 Units Data Table

Each row represents one unit and includes the following columns:

3.4.1.3 Unit Statuses and Actions

In the Tokenizer.Estate admin panel, each unit has a status that reflects its current state and the operations that are available with this unit. There are three distinct unit statuses:

1. Not published

• Assigned automatically when a unit is first created.
• Assigned when the unit was unpublished.
• Unpublished units still count in statistics; their transactions are displayed in the transactions section of the website.
• Unpublished units do not display in the Available Real Estate Opportunities list on the investor backoffice, but they display in users’ portfolios.
• Units in this status can be:
  • Published (only from the detailed view)
  • Archived (both from the list and from the detailed view)

2. Published

• After all necessary fields were populated, the unit can be published by clicking the corresponding button in the detailed unit view. After that, the unit will appear on the investor's backoffice with all the populated information.
• Note that before the admin has published the smart contract, the unit will appear on the investor's backoffice with a label “Coming soon”, and its tokens will not be available for purchase.
• Units in this status can be:
  • Unpublished (only from the detailed view)
  • Archived (both from the list and from the detailed view)

3. Archived

• If the unit's activity has ended, all obligations are closed, then the unit can be archived – it will be unpublished, delisted from the investor's backoffice, but will still be displayed in users’ portfolios.
• Units in this status can be:
  • Anarchived (only from the detailed view) – then they become Unpublished

These statuses help admins manage the lifecycle of each unit — from initial creation and publishing to archiving or deletion — ensuring transparent control over what is displayed to end users and maintaining the integrity of platform records.

3.4.2 Create a New Unit

To add a new unit:

1. Go to the Units section in the left menu.
2. Click the green "Create New Unit" button in the top-right corner.
3. A modal window titled "Add new unit" will appear.

You must fill in the following fields:

• Unit name is a required text input used to specify the name of the real estate object being tokenized. Input guidelines:
  • The name should clearly describe the unit (e.g., "Skyline 3BR Apartment, Downtown Dubai"). 
  • Avoid placeholder text or internal codes that may confuse users.
  • The name must be unique within the platform to prevent ambiguity.
• Unit type is required; choose one from the drop-down list. 

Click "Create Unit" to complete.

Once created, the new unit will appear in the Units list with the “Unpublished” status tag, and you will be redirected to this Unit’s detailed view. At this moment Unit does not display on the investor backoffice yet.

3.4.3 Unit Detailed View

From the Units section, double-click on any unit’s name (first column) in the list to open its full card. The view contains multiple tabs:

• General (default active tab)
• Description
• Financials
• Images
• Documents
• Transactions
• Owners
• System logs

Above the tabs in the right corner of the screen, there is an Actions Block with various buttons, providing the ability to modify the unit’s status or publication stage.

3.4.3.1 Actions block

The Actions panel is located in the top-right corner of each unit’s detailed view. Available actions change depending on the current status of the unit. This allows administrators to manage the visibility and lifecycle of the unit efficiently.

When the unit is in Not Published status

• Publish Unit – Makes the unit visible on the investor backoffice under Available Real Estate Opportunities.
• Preview – Opens a preview version of the unit page as it will appear on the investor backoffice.
• Archive – Delists the unit from the Available Real Estate Opportunities on the investor backoffice, the unit no longer counts in statistics, and its transactions do not display on the transactions page.

When the unit is in the Published status

• Undo changes – if, after publishing the unit, some changes were made to it but not deployed to the investor backoffice, the admin can undo the changes and restore the previous version.
• Unpublish Unit – Moves the unit back to Not Published status. It will be delisted from the investor backoffice public listing, but will remain in user portfolios.
• Preview – Allows checking the live view of the unit on the investor backoffice.
• Archive – Delists the unit from the Available Real Estate Opportunities on the investor backoffice, the unit no longer counts in statistics, and its transactions do not display on the transactions page.

When the unit is in an Archived status

• Unarchive – Restores the unit to the Not Published state.
• All publishing and editing actions are disabled until the unit is unarchived.

3.4.3.2 Publishing Smart Contract

To make a unit fully available for a token sale, you must publish a smart contract associated with it. This step is only possible from the unit’s detailed view and only when the unit is in the Not Published or Published state.

A smart contract is a self-executing program deployed on a blockchain that governs how tokens for a specific unit are created, distributed, and tracked. It ensures transparent, immutable, and decentralized ownership management. Without publishing a smart contract, the unit cannot have tokens available for purchase, and blockchain-based transactions will not be possible.

To publish a smart contract:

1. In the detailed view of a unit, click the Publish Now button next to the "Smart contract is not published" label.
2. A modal window titled Publish smart contract will appear.
3. Fill in the required fields:
   • Token name — the display name for the property token (e.g., “Hotel”)
   • Token symbol — a short symbol (like a stock ticker) that represents the token (e.g., “HTL”)
   • Total supply — the total number of tokens that will be generated and available for purchase (e.g., 70000)
4. Click Publish to confirm. After successful contract deployment, the unit remains in the same status it was before; if it was published, then its tokens are now available for purchase on the investor backoffice.

3.4.3.3 General

The General tab on a unit’s page allows administrators to view and define key information about a real estate unit. It adapts dynamically based on the unit Type (Residential, Commercial, or Land), showing relevant detail fields for each case.

These fields appear regardless of the unit type:

• Name – Internal and public-facing title of the unit.
  • Displayed in the admin panel for search and identification.
  • Visible on the investment platform.
  • Used in filtering and navigation.
• Slug – A URL-friendly identifier.
  • Typically auto-generated from the name.
  • Can be edited manually if needed.
• Type – Category of the property. Options:
  • Residential
  • Commercial
  • Land
    Based on this selection, a corresponding detail block will appear.
• Status – Current lifecycle state of the unit. Options:
  • Construction
  • Completed
  • Fundraising
  • Rented
• Location – Full address or location label for the unit.
  • Includes a "Search on map" feature to validate positioning.

Depending on the selected Type, the following sub-blocks are displayed to enter type-specific information:

Residential Details

Used for apartments, houses, condos, etc.

• Bedrooms – Number of bedrooms.
• Bathrooms – Number of bathrooms.
• Total area – Size of the unit.
• Measure – Unit of measurement (m², ft²).
• Property type – Select from Apartment, House, Condo, Townhouse, etc.

Commercial Details

Used for offices, retail units, or warehouses.

• Total area – Size of the property.
• Measure – m² or ft².
• Number of units – Total internal divisions (e.g., shops or offices).
• Parking spaces – Available parking slots.
• Building class – Commercial grade (Class A/B/C).

Land Details

Used for undeveloped plots or agricultural land.

• Acreage – Land area value.
• Acreage unit – Acres or hectares.
• Zoning type – Legal designation (e.g., Residential, Commercial, Agricultural, Industrial).
• Utilities available – Select from Electricity, Water, Gas, Sewer, Internet (multi-select).
• Current use – Present activity or purpose (e.g., farmland, idle).
• Soil type – Description of the soil (e.g., clay, loam).

Compliance Section

This block captures KYC-related metadata:

• Issuer company name – Legal name of the entity offering the property.
• Issuer company country – Country of incorporation.
• Liquidity score – Internal metric used to assess how easily the unit’s tokens could be traded.

Blockchain Section

This section is used to configure blockchain-related data for tokenized units:

• Receiving wallet – Ethereum address where tokens will be issued.
  • Editable depending on admin permissions.
  • Used as the destination when pressing “Send Tokens.”
• Accepted currencies – Toggle support for:
  • USDT
  • USDC
    Only selected currencies will be available to investors during purchase.
• Smart contract addresses:
  • Token contract – ERC-based contract that manages token minting and burning.
  • Payout contract – Handles automated yield/revenue distributions.
  • Master wallet – Platform-level fallback or treasury wallet.
    Each address is copyable and links out to a block explorer.
• Send Tokens button – Executes backend operation to issue tokens to the receiving wallet.
  • Enabled only for units with valid blockchain configuration and Completed status.

3.4.3.4 Description

Add a marketing description of the unit using a text editor. This is shown to investors on the investor backoffice.

3.4.3.5 Financials

The Financials tab allows you to input and manage projected returns, costs, and investment thresholds for each unit. This information is used to inform investors and power financial calculators on the platform.

At the top, choose a unit currency from the drop-down list. All the major fiat currencies are supported.

Here you can also set up the property price and property token price in the currency that was chosen earlier.

You can enter financial projections and cost data for the following fields:

All fields accept percentages or currency values depending on the context.

Changes are stored immediately upon confirmation, and the Publish Changes button in the top right will push them to the live investor backoffice once you're ready.

3.4.3.6 Images

Upload property images that will be shown to investors. These should be high-quality and reflect the property’s actual state.

The Images tab allows you to upload, manage, and reorder property images that will be displayed on the public investment page for the unit. Visual presentation plays a key role in attracting investors, so high-quality images are strongly recommended.

To upload images:

• Drag and drop files into the upload zone, or click Browse to select files manually.
• Supported formats: .png, .webp and .jpeg / .jpg
• Maximum file size: 10 MB per image
• Recommended resolution: minimum width of 1600px for optimal display on the investor backoffice

Uploading progress is shown in the bottom-right corner.

Once uploaded, images appear in a grid layout.

You can:

• Reorder images by dragging them — the first image becomes the cover photo on the investor site.
• Delete any image by clicking the 🗑 icon in the top-right corner of its thumbnail.
• Upload additional images using the “+” tile.

Changes are applied immediately but will only appear on the investor backoffice after clicking Publish Changes.

3.4.3.7 Documents

The Documents tab allows you to upload and manage all supporting files related to the tokenized property unit. These documents are typically made available to investors on the public unit page, helping ensure regulatory compliance and increasing transparency.

You can upload:

• PDF (.pdf)
• Word documents (.docx)
• Spreadsheets (.xlsx)
• Images (.jpg, .jpeg)

File size limit: 10 MB per file.

To upload files:

• Drag and drop them into the designated area
• Or click Browse to manually select files from your device

Upload progress is shown in a floating status panel at the bottom right.

Once uploaded, files are listed with the following actions:

• Rename the file by clicking the pencil icon
• Delete the file by clicking the trash bin icon

You can upload more files anytime using the "+" button at the bottom of the list.

3.4.3.8 Transactions

The Transactions tab displays all blockchain-based activity related to token purchases and transfers for a specific unit. This tab provides visibility into the flow of funds and tokens between investors and the platform.

Each transaction entry includes:

• Unit – this real estate unit.
• User email – The email address of the user who initiated the transaction.
• User wallet – The blockchain wallet address from which the transaction was made.
• Type – indicates the nature of each transaction, helping administrators quickly distinguish between Investment, Transfer, and Withdrawal operations.
• Value – the monetary value of the transaction (e.g., $1,000,000.00)
• Tokens – the number of tokens transferred (e.g., 1,000,000)
• Payment transaction hash – a blockchain hash for the payment operation (includes copy and external view icons)
• Tokens transaction hash – a hash for the actual token issuance or transfer
• Transaction time – timestamp of the blockchain event
• Status – transaction state (e.g., Completed, Failed)

You can search or filter by all the mentioned parameters.

This helps admins investigate failed transactions, audit sales, or trace investor activity.

3.4.3.9 Owners

The Owners tab displays a comprehensive list of all investors who currently hold tokens for the selected unit. It offers insight into token distribution and user engagement, helping administrators track ownership and investor activity.

Each row includes:

• User wallet – the blockchain wallet address (with copy and external explorer icons)
• Email – user’s registered email
• First name / Last name – full name of the user
• Country – user’s country of registration (with flag icon)
• Registration time – when the user registered on the platform
• Last online – the last time the user accessed the platform
• Status – Active or Blocked
• Token balance – number of tokens the user holds for this unit
• First transaction / Last transaction – time range of investment activity related to this unit

Admins can:

• Search by wallet, name, or email
• Filter by country, registration date, activity status, or balance
• Sort by any column

This makes it easy to identify top investors, troubleshoot blocked users, or analyze token ownership trends.

3.4.3.10 Timeline

The Timeline tab provides a chronological log of important events related to the selected unit. It helps administrators document and review milestones such as construction updates, project completions, or other significant activities, ensuring transparency for both internal teams and investors.

Each row includes:

• Event Date – the date when the event occurred, displayed in month/year format
• Headline – a short title describing the event (e.g., Construction Ended)
• Text – an optional extended description with more details about the event
• Category – classification of the event (e.g., Unit updates)
• Actions – edit and delete buttons allowing administrators to update or remove the event

Admins can:

• Create new events using the Create New Event button
• Search by headline, text, or category
• Filter events by date, headline, description, or category
• Export all timeline events into a CSV file for reporting
• Reset filters to view the full, unfiltered list

This makes it easy to maintain a clear historical record of each unit, track key milestones, and ensure consistent communication with stakeholders.

You can use this tab to:

• Document important project or construction phases
• Provide transparent updates to token holders
• Review and export a full history of unit-related activities for compliance or reporting

To add a new event to the timeline:

1. Open the Event Creation Form

Click the Create New Event button located in the top-right corner of the Timeline tab. This will open a form where you can input event details.

2. Fill in the Event Fields

• Event date
  Select the date when the event occurred or will occur. This is used to position the event in the timeline chronologically.
• Event title
  Enter a concise title summarizing the event (e.g., “Construction Ended”, “Unit Sold”, “Legal Approval Received”).
• Category
  Choose a category from the dropdown to classify the event. Categories help organize events and may be used for filtering later. You can choose either "Payouts and earnings" or "Unit updates"
• Event description
  Provide a description (up to 1000 characters) with more context or details about the event. This may include internal notes, links, or project references.

3. Submit the Event

Once all required fields are filled in, click the Create button to save the event. The event will be added to the unit’s timeline, and the notification about it will be sent to all unit owners.

3.4.3.11 System logs

The System Logs tab provides a chronological record of all administrative actions, edits, and updates performed on a specific unit. It helps administrators ensure accountability, trace changes, and maintain transparency across the lifecycle of the unit’s data.

Each row in the system log represents a single recorded action and includes the following details:

• Time – exact date and time when the action occurred.
• Performed by – the admin or user who executed the action.
• Action – the type of activity performed (e.g., Edit unit, Publish unit, Rollback, Delete image).
• IP Address – the originating IP address of the user who made the change, useful for security and auditing.
• Info – descriptive context for the action, providing details of what was changed (e.g., Edited Unit #385: updated title, price, and availability).

In this tab, the admin can:

• Search and filter:
  • By time (date range)
  • By user (Performed by)
  • By action type
  • By IP address
  • By info text (full-text search)
• Sort logs by any column (e.g., show newest actions first).
• Export to CSV for compliance reporting or deeper analysis.
• Reset filters to quickly return to the full audit log.

3.4.3.12 Weekly Snapshot

The Weekly Snapshots tab on the Unit page provides a detailed weekly history of key unit metrics and compliance-related metadata. It is designed for transparency, audit support, and regulatory reporting.

Each row represents a snapshot for a specific week. The table supports text search, filter-by-column, and CSV export.

Columns

Features:

• Filtering: Each column supports filtering (text input or dropdowns) for easier data navigation.
• CSV Export: Snapshots can be exported for reporting using the Download CSV button.
• Reset Filters: Resets all applied filters to default view.

3.4.3.13 Notifications

The Notifications section on each Unit Page allows administrators to manage and broadcast messages specific to that property. This feature ensures stakeholders remain informed about updates, changes, or important announcements directly related to individual units.

Unit-level notifications offer admins the ability to:

• Send timely updates to users involved with the unit (e.g., investors, managers).
• Categorize messages for easier tracking and context (e.g., Marketplace Updates, Legal Notices).
• Maintain a historical record of all sent notifications per unit.

The table with notifications supports various filters to narrow results:

• Timestamp – Filter by specific date ranges.
• Category – Filter by predefined notification categories (e.g., Marketplace Updates, Compliance).
• Users – Show notifications targeted to specific users.
• Headline – Search by title content.
• Text – Search within the body of the notification.
• Status – Filter by delivery status (e.g., Sent, Pending).

Each row in the notification table includes:

• Timestamp – The exact time the notification was sent.
• Category – The assigned label indicating the type of notification.
• Users – The target recipients (if specified).
• Headline – The title or subject of the message.
• Text – The full message body.
• Status – Current state of the notification (e.g., Sent).

To send a new message:

1. Click the “Create New Notification” button.
2. In the pop-up modal:
   • Category – Select a relevant category from the dropdown.
   • Notification Title – Enter the headline (this appears as the subject line).
   • Notification Description – Provide the body text with any relevant information.
3. Click “Send Notification” to broadcast the message to users associated with this unit.

All sent notifications are saved and remain accessible in the unit’s notification log.

3.4.3.14 Blockchain

The Blockchain tab provides administrators with direct interaction capabilities between Tokenizer.Estate and the underlying smart contracts for each tokenized property. This tab is available only to admins with the appropriate blockchain permissions and is designed to offer a transparent, secure, and convenient way to manage token-related operations directly from the Admin panel.

Located within the Unit detailed view, the Blockchain tab displays essential smart contract data such as total and available tokens, transaction history, and sales performance. Admins can connect a supported wallet (e.g., MetaMask) to execute contract operations in real time. Once connected, all available functions dynamically appear based on the user’s role and permissions.

1. Wallet Connection
Admins must connect a supported wallet to interact with the smart contract. Once connected, the system displays the wallet address, balance, locked balance, and assigned roles.

2. Address Information Lookup
Allows quick on-chain verification of any address by entering it manually and retrieving associated balance and role information.

3. Smart Contract Actions
Depending on assigned permissions, admins can:

• Mint / Burn Tokens – Create or remove tokens from circulation.
• Pause / Unpause Contract – Temporarily suspend all token transfers, minting, or burning operations. This feature includes a confirmation modal and clear visual indicators of the contract’s status.
• Force Transfer – Move tokens between addresses if required for administrative purposes.
• Grant / Revoke Roles – Manage blockchain roles directly from the interface.
• Lock / Unlock Balances – Restrict or release a user’s token balance.

4. Transaction Visibility
All blockchain actions are logged in real time. When the contract is paused, the interface displays a red warning banner:

“The contract is currently paused. No transactions can be executed until it is unpaused.”

Each operation includes validation, loading states, and success/error notifications to ensure reliable execution. The UI also prevents unauthorized actions by checking wallet roles before displaying available methods.

This feature bridges the gap between the admin dashboard and blockchain operations, giving Tokenizer.Estate administrators a complete, role-based interface for managing tokenized assets securely and efficiently.

3.4.4 Version history

At the top of the unit’s detailed view page, next to the unit name and timestamp, there is a green “Version History” link.
Clicking this link opens a modal displaying a chronological list of all saved versions of the unit.

Admins can narrow down the list using either a text search or a date filter.
The currently active version is marked with a violet “Current version” label for quick identification.

Each version entry has:

• An eye icon on the right; clicking it opens that specific version of the unit in a new browser tab, showing exactly how it appears in the frontend back office
• Restore button; clicking it restores that specific version of the unit, filling all the fields with the corresponding values for this version. Note that the restored values will be in the draft state. If you want them to be published, you need to do it separately.

3.4.5 Tokenomics

The Tokenomics section becomes available once the unit’s smart contract is published. It provides administrators with insights into the token supply, sales performance, and transaction activity related to the specific unit. This section ensures transparency around token distribution and helps track investor participation over time.

Each card or widget in Tokenomics provides specific details:

• Tokens
  • Total tokens – the overall supply defined in the published smart contract.
  • Tokens available – the number of unsold or unallocated tokens remaining.
  • Visualization – a donut chart representing the ratio of available vs. allocated tokens.
• Token Sales
  • Displays the number of tokens sold across time.
  • Line graph showing sales performance per month.
  • Total sold tokens are summarized above the graph.
• Transaction History
  • First transaction – record of the earliest purchase, including date, time, and number of tokens.
  • Last transaction – record of the most recent purchase, including date, time, and number of tokens.
  • Timeline visualization that plots token sales chronologically.