How to report a problem
Where to write, what to include, where the logs are, and how to hand over data safely so we can reproduce it. The person reading is the person building the product.
Getting in touch
- Email: tabledi@thingworks.com.cn
- The feedback entry at the top right of the app's home screen
Include these and it lands in one go
- The version — Desktop settings → About.
- The system — macOS or Windows, and which version.
- What you did, what you expected, what actually happened, step by step.
- A screenshot of the error and the interface at the time.
- The logs (below).
Where the logs are
The engine's log — formulas, imports, connections, automation:
- macOS:
~/Library/Application Support/tabledi-desktop/TableDI/logs/ - Windows:
%APPDATA%\tabledi-desktop\TableDI\logs\
The file starting error is the useful one. The application's own log — startup, updates, licensing:
- macOS:
~/Library/Logs/tabledi-desktop/main.log - Windows:
%APPDATA%\tabledi-desktop\logs\main.log
The startup error dialog and the Your data is not ready yet page both have an Open log folder button, and both open the folder holding that main.log; the engine's log you fetch from the data folder yourself. Neither log contains your table contents or your API key.
Anonymous crash reports
Desktop settings → Privacy & diagnostics. With it on, crashes and exceptions are reported anonymously, with no business data, file contents or personal information. Leaving it on means a good number of problems get fixed without you having to write in at all. You can turn it off whenever.
Handing over data for a reproduction
- First see whether the sample data, or a few anonymised rows, reproduces it.
- When the whole thing is needed, export a
.tdbk(Desktop settings → Data backup) and send that. It is encrypted, opens only in TableDI, and does not contain your API key. - For data you would rather not send, describing the field types and the formulas clearly is usually enough.
Things the manual doesn't cover
Tell us what you were looking for and did not find. This manual is updated from what people ask, so your question is the next page.