Commands Reference

Every table you create gets its own slash command, named after the table, with these subcommands. Replace <table> with your table's command name, for example /inventory.

Quick Reference

/<table> addWrite
/<table> queryRead
/<table> updateWrite
/<table> deleteAdmin
/<table> viewRead
/<table> leaderboardRead
/<table> saved-viewRead
/<table> bulk-updateAdmin
/<table> bulk-deleteAdmin

/<table> add

Write

Add a new row. Every table gets its own command named after the table, and each column becomes an option. Required columns are listed first and must be filled in; optional columns can be skipped.

Syntax

/<table> add <column>:<value> <column>:<value> ...

Example

/inventory add item:Diamond Sword quantity:3 rarity:Epic
  • •The Discord user who ran the command is stored with the row.
  • •The bot replies with a confirmation and the values that were saved.
  • •Each plan has a per-table row limit (100 on Free). The bot tells you when a table is full.

/<table> query

Read

Search a table. Every column is an optional filter; leave them all out to list rows.

Syntax

/<table> query [<column>:<value> ...] [limit:<1-25>]

Example

/inventory query rarity:Epic limit:10
  • •Text columns match when the value contains what you typed. Other column types must match exactly.
  • •Shows 10 results by default, up to 25.

/<table> update

Write

Change an existing row. Pick the row from the autocomplete list, then provide only the columns you want to change.

Syntax

/<table> update row:<row> <column>:<new_value> ...

Example

/inventory update row:Health Potion quantity:9
  • •Columns you leave out keep their current values.
  • •On tables with Number columns, the _mode option chooses whether numbers are set, incremented or decremented.

/<table> delete

Admin

Delete a single row. The bot asks you to confirm with a button first.

Syntax

/<table> delete row:<row>

Example

/inventory delete row:Rope
  • •Deleted rows disappear from the table right away and are permanently erased after 30 days.

/<table> view

Read

Show every column of a single row in one embed.

Syntax

/<table> view row:<row>

Example

/inventory view row:Diamond Sword
  • •Also shows who created the row and when it was created and last updated.

/<table> leaderboard

Read

Rank rows by a Number column, highest first. The top three get medals.

Syntax

/<table> leaderboard column:<number_column> [limit:<1-25>]

Example

/xp leaderboard column:XP limit:10
  • •Only added to tables that have at least one Number column.
  • •Shows 10 places by default, up to 25.
  • •Each score is shown next to the row's first Text or Member column.

/<table> saved-view

Read

Run a saved view you set up for the table in the dashboard.

Syntax

/<table> saved-view name:<view> [limit:<1-25>]

Example

/inventory saved-view name:Epic items
  • •Only added to tables that have at least one saved view.

/<table> bulk-update

Admin

Change one column on every row where another column matches a value. Pro and Team plans only.

Syntax

/<table> bulk-update filter:<column> value:<match> set-column:<column> set-value:<new_value>

Example

/inventory bulk-update filter:item value:Rope set-column:rarity set-value:Common
  • •The bot shows how many rows match and asks you to confirm before changing anything.

/<table> bulk-delete

Admin

Delete every row where a column matches a value. Pro and Team plans only.

Syntax

/<table> bulk-delete filter:<column> value:<match>

Example

/inventory bulk-delete filter:rarity value:Common
  • •The bot shows how many rows match and asks you to confirm before deleting.

Global Command Behaviour

  • Ephemeral errors — Permission errors and validation failures are shown only to the user who ran the command (ephemeral messages), keeping channels clean.
  • Autocomplete — Select columns show their options as a list of choices. The row and saved-view options suggest matches as you type.
  • Rate limits — Commands are rate-limited to 5 per user per 10 seconds to prevent abuse. This is well above normal usage.
  • Embeds — All responses use Discord embeds with clean formatting. Data is shown in tables or key-value pairs depending on the command.
  • Permissions — Until you assign roles to a table, every member can run all of its commands. Once roles are set, only members with a listed role can use the table: Read covers query, view, leaderboard and saved-view; Write adds add and update; Admin adds delete and the bulk commands. Discord administrators can always run everything.
  • Global commands — /help lists your server's tables, /ping checks the bot is online, and /delete-my-data deletes the rows you created in every server.