Skip to main content


A listing of table, data, and query limits.

Since Tableland is still in open beta, each table is limited to the following constraints while the full production network is further clarified. These are temporary limits while the production mainnet is further researched.

Table limits

ConstraintMax size

Data limits

Each cell limit is 1kb.

Tableland is not a file storage solution. Instead, use pointers to solutions like IPFS, Filecoin, & Arweave to enable large file integrations and store the pointers in table cells.


Since the Tableland network is currently in open beta, row limits have been imposed. When Tableland launches a production network (its own mainnet), there likely won’t be row limits. This is subject to change based on pending research.

Query limits

Query size is limited to a maximum of 35kb.

Recall that mutating queries require an onchain operation—thus, a limit for write queries must abide by standard blockspace constraints. That is, Tableland inherits EVM-based limitations, including computational gas that exceeds the gas limit. For reference, multiple transactions are fully supported such that one or more SQL statements can exist in a single block, which could near this query limit for a large set of writes.

Note that on Ethereum, due to the block gas limit (30 million gas), the query limit is reached when it is around 14.5kb. In other words, query size is limited to 14.5kb when writing to Ethereum mainnet only; other chains should assume a maximum of 35kb.


You can create tables and write data to it within the same onchain transaction, but note that database operations are atomic. If one of these fail, then all operations in that transaction fail—so be careful to not exceed the query size limit!

Query "lag"

When a table is created or written to, there will be a "lag" between calling the smart contract and the time at which the event’s SQL instructions are materialized in Tableland. This "lag" is documented below as a chain-driven limitation due to block times and block depth. See the chains page for more information on how this works.

ChainAvg. block finalization timeBlock depthAvg. SQL materialize time
Ethereum13.5 seconds130-40 seconds
Optimism2 seconds0<5 seconds
Arbitrum One<2 seconds0<5 seconds
Arbitrum Nova2-3 seconds0<5 seconds
Base2 seconds0<5 seconds
Polygon2 seconds1<10 seconds
Filecoin30 seconds5~4 mins.

Table reads

All table reads must happen through an offchain interaction using an unauthenticated REST API call to a Tableland validator node's gateway.

The TL;DR is that table reads directly access the Tableland network, and mutating database instructions (create & write transactions) are onchain actions. You can make read queries at a gateway, such as the one hosted by the core Tableland team. For more information, see the docs on gateways.


It is not possible for a smart contract to read data from a table created in Tableland. Using an oracle or some offchain logic to write data back on chain (e.g., inbox-outbox type of setup) is an alternative.