Entity Types

Entity types are the foundation of WISEROWS's data model. Think of them as custom database tables with a built-in UI -- you define the schema, and WISEROWS automatically generates table views, kanban boards, galleries, calendars, forms, and API endpoints.

Whether you're tracking blog posts, leads, products, keywords, or any other data shape, entity types give you a flexible, no-code way to model it all.

Why Entity Types?

Most platforms force you into rigid data models. WISEROWS flips this: you define the shape of your data, and the platform adapts to it.

• No database migrations -- add, remove, or reorder fields at any time
• Instant UI -- every entity type gets four views, inline editing, filtering, and sorting out of the box
• API-first -- every entity type is automatically available via the REST API
• AI-aware -- fields can be auto-generated by AI using context from other fields
• Workflow-ready -- connect entity types to workflows for automated content pipelines

Creating an Entity Type

Schema Properties

Every entity type has these configurable properties:

Fields

Each entity type has an ordered list of field definitions that make up its schema. Fields are the columns in your table, the attributes on your cards, and the inputs in your forms.

Every field has these properties:

Adding and Reordering Fields

In the Schema Builder, click Add Field on your entity type to add a new field. Select the field type from the dropdown, then configure its properties.

Drag fields to reorder them. The order determines how they appear in table columns, forms, and the API response.

Field Slug Rules

Field slugs must:

• Start with a lowercase letter
• Contain only lowercase letters, numbers, and underscores
• Match the pattern: ^[a-z][a-z0-9_]*$

Examples: title, meta_description, price_usd, publish_date

Sidebar Configuration

Control how and where the entity type appears in the application sidebar:

Advanced Configuration

Entity types support several advanced features that integrate with WISEROWS's broader platform capabilities.

Content Generation

Enable AI-powered content generation on an entity type to let users generate field values with a single click. Configure a prompt template that references field slugs, and the AI fills in the blanks.

This connects to WISEROWS's content generation system and is especially powerful when combined with Content Buckets.

Status Workflows

Attach a status workflow to an entity type to define a progression of stages (e.g., Draft, Review, Published, Archived). This powers the kanban view and enables workflow automations.

Data Quality Rules

Configure data quality checks that validate entities against custom rules. This is useful for SEO readiness checks, content completeness scoring, and compliance validation.

Meta Fields

Enable meta fields to automatically add SEO-related fields (meta title, meta description, canonical URL, etc.) to the entity type. These are used by the programmatic SEO system and content publishing workflows.

API Access

Every entity type is automatically available via the Entities API. No additional configuration needed.

You can:

• List entities with filtering, sorting, and pagination
• Create entities with validation
• Update individual fields or entire entities
• Delete entities (soft delete with optional hard delete)

# List all entities of type "blog-post"
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://your-project.convex.site/api/v1/entities?entityType=blog-post

# Create a new blog post
curl -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"entityTypeSlug": "blog-post", "fields": {"title": "Getting Started", "status": "draft"}}' \
  https://your-project.convex.site/api/v1/entities

Real-World Examples

Frequently Asked Questions

Related