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.

• Column sorting: Small arrows to the right of the column name can be used to sort by the column content; pressing the icon again will sort in the opposite direction. There are different types of sorting for different columns:
  • alphabetically (A–Z / Z–A) for text columns such as Unit, Slug, etc.
  • by date (from earliest to latest and back) for Created at
  • by status order for the Status column
• Column Filters: each table column supports its own filter or input field to narrow down results:
  • ID – free text input for Units’ IDs.
  • 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.
  • Created at – date range picker for filtering by the date of creation
  • Status – dropdown filter for statuses like Published, Archived, or Not published.

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 includes:

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 backoffice. However, it 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 enable admins to manage the lifecycle of each unit — from initial creation and publication 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. Navigate to the Units tab in the sidebar.
2. Click the green Create Unit button at the top-right corner of the page.
3. Fill the pop-up Unit creation modal:

• 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 real estate object (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.
• Type is required; choose one from the drop-down list. 

Click the Create Unit button 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
• Media
• Documents
• Blockchain
• Transactions
• Owners
• Weekly Snapshot
• System logs
• Notifications
• Compliance

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

• Reset 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, available if the unit has unpublished changes.
• 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 Smart Contract 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's 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
• Mark as featured checkbox — sets the current unit as the featured one to be displayed on the investor-facing website. Only one unit can be marked as featured at a time.
• 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.

3.4.3.4 Description

You can add a marketing description of the unit using a text editor on the Description tab. This is shown on the investor backoffice platform.

You can provide different descriptions for different languages. The default description is labeled Any/English. Click the Plus icon to add descriptions in another language ( e.g., Spanish, French, Russian, Turkish, Korean, etc.). Users will see the description in the language selected in their account settings.

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 public once you're ready.

3.4.3.6 Media

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

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

To upload media files:

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

The uploading progress is displayed in the bottom-right corner.

Once uploaded, media files appear in a grid layout.

You can:

• Reorder files by dragging them.
• Delete a media by clicking in the top-right corner of the media thumbnail and selecting Delete.
• Set an image as a cover by clicking in the top-right corner of the media thumbnail and selecting Set as Cover.
• Upload additional files 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.

Supported formats: .pdf, .doc, .docx, .xls, .xlsx

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.

After uploading all documents, press the Save Changes button.

3.4.3.8 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.3.9 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.

• Column sorting: Small arrows to the right of the column name can be used to sort by the column content; pressing the icon again will sort in the opposite direction. There are different types of sorting for different columns:
  • alphabetically (A–Z / Z–A) for text columns such as From user or To user
  • by date (from earliest to latest and back) for Transaction time
  • by status order for the Status column
• Column Filters: each table column supports its own filter or input field to narrow down results:
  • From user - free text input for senders' email addresses, full names, or IDs.
  • From address - free text input for senders' blockchain wallet address.
  • To user - free text input for recipients' email addresses, full names, or IDs.
  • To address - free text input for recipients' blockchain wallet address.
  • Payment transaction hash – free text input for blockchain hash of the payment operation.
  • Tokens transaction hash – free text input for the hash for the actual token issuance or transfer.
  • Transaction time  – date range picker for filtering by the timestamp of the blockchain event.
  • Status – dropdown filter for statuses like Pending, Completed, Failed

Each transaction entry includes:

At the bottom of the table:

• Rows per page selector – Adjusts how many entries are displayed (default is 10).
• Navigation controls – Allow browsing through multiple pages of history.

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

3.4.3.10 Owners

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

• Column sorting: Small arrows to the right of the column name can be used to sort by the column content; pressing the icon again will sort in the opposite direction. There are different types of sorting for different columns:
  • alphabetically (A–Z / Z–A) for text columns such as Email, Country, etc.
  • by date (from earliest to latest and back) for Registration Time and Last online
  • by status order for the Status column
• Column Filters: Each table column supports its own filter or input field to narrow down results:
  • ID – free text input for users’ IDs.
  • User Wallet – free text input for users’ blockchain wallet.
• Email – free text input for users’ email addresses.
• Full name – free text input for users’ full names.
• Country – dropdown filter with a list of countries.
• Registration Time – date range picker for filtering by the registration date.
• Last Online – date range picker for filtering by last online date.
• Status – dropdown filter for statuses like New, Active, Blocked, and Archived.
• First Transaction – date range picker for filtering by the date of the first transaction.
• Last Transaction – date range picker for filtering by the date of the last transaction.

Each row includes:

At the bottom of the table:

• Rows per page selector – Adjusts how many entries are displayed (default is 10).
• Navigation controls – Allow browsing through multiple pages of history.

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

You can use this tab to:

• Investigate user-related issues (e.g., blocked status or inactivity)
• Review investor token holdings before launching updates
• Monitor ownership concentration or regional distribution

3.4.3.11 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.

• Column sorting: Small arrows to the right of the column name can be used to sort by the column content; pressing the icon again will sort in the opposite direction. There are different types of sorting for different columns:
  • alphabetically (A–Z / Z–A) for text columns such as Custodian country.
  • by date (from earliest to latest and back) for Valuation time and other date columns.
• Column Filters: Each table column supports its own filter or input field to narrow down results:
  • ID – free text input for Units’ IDs.
  • Period – date range picker for filtering by the period of the snapshot.
  • Asset type – dropdown filter with a list of asset types.
  • Currency – dropdown filter with a list of currencies.
  • Nominal quantity – free text input for token amount associated with the unit.
  • Valuation time – date range picker for filtering by the timestamp of the market value calculation.
  • Issuer name – free text input for the entity responsible for the asset issuance
  • Custodian name – free text input for the name of the custodian holding the assets.
• Custodian country – dropdown filter with a list of countries.
• Report reference ID – free text input for the identifier of the external or internal compliance report.
• Report issuer – free text input for the name of the issuer of the report.
• Storage hash – free text input for the name of the snapshot hash.

Each row includes:

At the bottom of the table:

• Rows per page selector – Adjusts how many entries are displayed (default is 10).
• Navigation controls – Allow browsing through multiple pages of history.

3.4.3.12 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.

• Column sorting: Small arrows to the right of the column name can be used to sort by the column content; pressing the icon again will sort in the opposite direction. There are different types of sorting for different columns:
  • alphabetically (A–Z / Z–A) for text columns such as Performed by.
  • by date (from earliest to latest and back) for Time.
• Column Filters: Each table column supports its own filter or input field to narrow down results:
  • ID – free text input for the log's ID.
  • Time – date range picker to display activities only within that period.
  • Performed by – free text input for an admin's Full name, Email, or ID (depending on the admin's permissions) who triggered this action.
  • Action – dropdown filter for type of action (e.g., Permissions Update).
  • Type – dropdown filter to choose the type of action (Regular, Alert, System).
  • IP Address – free text input for IP address.
  • Info – free text input for searching across additional details included in activity metadata.
• Reset All Filters – clears all filters and shows the full list.
• Refresh table – refreshes the data in the table.
• Download CSV – exports the table in CSV format.

Each row includes:

At the bottom of the table:

• Rows per page selector – Adjusts how many entries are displayed (default is 10).
• Navigation controls – Allow browsing through multiple pages of history.

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.

All notifications are reflected in the table:

• Column sorting: Small arrows to the right of the column name can be used to sort by the column content; pressing the icon again will sort in the opposite direction. There are different types of sorting for different columns:
  • alphabetically (A–Z / Z–A) for text columns such as User.
  • by date (from earliest to latest and back) for Timestamp.
  • by status order for the Status column.
• Column Filters: Each table column supports its own filter or input field to narrow down results:
  • ID – free text input for the Notifications' ID.
  • Timestamp – date range picker to display activities only within that period.
  • Category – dropdown filter for notifications' category.
  • User – free text input for a user's full name, Email, or ID (depending on the admin's permissions) who triggered this action.
  • Headline – free text input for the title of the message
• Text – free text input for message body.
• Status – dropdown filter for statuses.
• Reset All Filters – clears all filters and shows the full list.
• Refresh table – refreshes the data in the table.

Each row includes:

At the bottom of the table:

• Rows per page selector – Adjusts how many entries are displayed (default is 10).
• Navigation controls – Allow browsing through multiple pages of history.

To send a new message:

1. Click the Create 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 the Create Notification button 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.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.