Skip to main content


Certain classes of objects in Datagrok have a common set of operations and features applicable to them. We call these objects entities. Here they are:

The following operations can be applied to any entity:

  • Getting its URL
  • Referencing it in a chat, in markup, or a dashboard
  • Assigning privileges, such as rights to view, edit, or share, to a particular instance
  • Using it as a parameter in the audit record
  • Deleting it


Any entity can be annotated with metadata, which you can use to search entities. In Datagrok, there are three kinds of metadata:

  • Tags
  • Parameters
  • Properties


A tag is a short string that can be associated with any entity. Use it to organize and group different entities. For example, a #chem tag could be used with chemical scripts, molecular datasets, or chemical database queries.

To search for tagged entities, enter #tagname in the search box.


Each entity can be associated with a list of key-value pairs.

To search for entities with the specified parameters, use the <paramName> <op> <value> syntax, where op is an operator like > !=.

For example:

  • imported < 10/02/2019
  • rows > 200
  • author = @current


Properties are similar to parameters, but unlike parameters, properties can include nested properties. Additionally, you can't edit them directly.

Some properties are universal across all entities. Others are specific to particular entity types. Common properties include:

  • ID
  • name
  • author
  • createdOn
  • updatedOn
  • commentedBy
  • usedBy
  • starredBy

You can use metadata to search for entities

See also: