2.8 Adding Your First Real Estate Unit

The Units section allows you to create, configure, and publish tokenized real estate offerings on your platform. Each unit represents a separate property (or share of a property) that investors can purchase tokens in.

2.8.1 Create 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 modal:
   • Name: Enter the internal name of the property.
   • Type: Select the category (Residential, Commercial, Land).
4. Click Create Unit to proceed to the editing interface.

2.8.2 Fill Out Unit Details

After creation, you’ll be redirected to the unit configuration screen. with multiple tabs:

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

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

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

2.8.2.4 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's backoffice after clicking Publish Changes.

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

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

2.8.2.7 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:
  • ID – free text input for a unique system transaction identifier.
  • 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.

2.8.2.8 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 owners’ 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

2.8.2.9 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 snapshot ID.
  • 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.

2.8.2.10 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 (Text Filter) – free text input for searching across additional details included in activity metadata.

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.

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

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.

2.8.3 Publication Flow

Once all unit information has been entered and saved across all tabs, the top-right toolbar provides controls to preview, publish, or archive the unit. The top left toolbar offers an opportunity to manage versions of the unit.

• Preview
  Opens a read-only view of how the unit will appear on the investor's backoffice. Use this to verify correctness before publishing.
• Publish Unit
  Publishing the unit on the investor's backoffice. 
• Archive
  Moves the unit to an archived state. The unit will no longer appear on the investor backoffice, but will remain visible in the admin panel.

When the unit is published, all changes you make will be stored as a draft until you publish them. When a unit has a draft, it displays with the draft icon on the top-right toolbar. You can also cancel the latest changes with an arrow to the right of the Draft label.

Anytime you can have a look at any stored version of the unit and publish any of them from the Version History link on the top left toolbar.

You can unpublish the Unit with the Unpublish Unit button

If you publish a unit without publishing its smart contract, it will still become visible on the investor-facing website, but in a limited Coming Soon state.

• The unit’s details, media files, and description will be visible.
• The token purchase options will be disabled.
• A Coming Soon badge will appear in the top-right corner of the unit card.
• Users can click Notify Me On Launch to subscribe to updates about its future availability.

To make the unit fully available for investment, you must click the Publish Smart Contract button in the admin panel to deploy the smart contract and enable on-chain transactions.

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