Your Workspace

My Data

What should your agents, workflows and web apps know? My Data holds it: tables, uploaded files, websites, text and file buckets. Everything you build in Studio can work from it, and you do not need an external database.

Overview

The My Data page is your central hub for all data in the workspace. Create tables that work as built-in databases for users, products, orders or any structured data. Upload PDFs, read in a website or paste text so your agents can answer from it. Set up buckets to store files.

The menu on the left lists your Collections. All Sources shows everything; click + next to Collections to add one.

When the workspace has no data yet, the page shows Add data and five ways to start:

Option What it creates
Create a table Rows and columns your workflows can read and write
Upload files PDF files for your agents to read
Add a website Pages from a website, read in as text
Add text Text you paste in directly
Create a bucket File storage for workflows, public or private

Tables created by Qira and Vira while they build a web app appear here too, so you can view and edit their rows.

Each data source appears as a card showing:

Field Description
Icon The data source type (table, document, text, web)
Name The name you gave the data source
Description Optional description (shown below the name)
Status badge Current state - Ready (green) or Busy (orange, while indexing or processing)
Created date When the data source was created

Click the gear icon on any card to open its settings. Click Add data to add a new data source.

Data Source Types

Type Shown as Description
PDF Files Upload files Upload PDF documents for text extraction and chunked indexing
Scrape Website Add a website Extract content from web pages automatically
Raw Text Add text Paste or type plain text content directly
Table Create a table Create structured data with columns and rows
Bucket Create a bucket Store files that workflows upload and serve, public or private

Each type has its own creation flow and configuration options.


PDF Files

Upload PDF documents to extract their text content and make it searchable through RAG queries.

Creating a PDF Data Source

  1. Click Add data → Upload files
  2. Enter a Name for the data source
  3. Drag and drop PDF files into the upload area, or click to browse (limit of 5 files, 10MB total)

Advanced Settings

Expand Advanced Settings to configure how the PDF text is split into chunks for indexing.

Chunk Strategy

Strategy Description
Fixed Size Splits text by a fixed character count. Simple and predictable.
Sentence Splits at sentence boundaries. Keeps sentences intact for better context. Selected by default.
Paragraph Splits at paragraph breaks. Best for documents with clear paragraph structure.
Semantic AI-powered semantic splitting. Groups related content together automatically.

Chunk Size & Overlap

Setting Description
Chunk Size The target size of each chunk. Options: 500, 1000, 1500, 2000 tokens. Default is 1000 tokens.
Chunk Overlap How many tokens overlap between consecutive chunks. Options: 0, 100, 200, 300 tokens. Default is 200 tokens.

Overlap ensures that context isn't lost at chunk boundaries. A 200-token overlap means the end of one chunk and the start of the next share 200 tokens of text.

Click Create Data Source to upload and process the files. The status will show Busy while indexing, then switch to Ready when complete.


Scrape Website

Extract content from web pages and index it as a data source.

Creating a Web Scraper Data Source

  1. Click Add data → Add a website
  2. Enter a Name for the data source
  3. Enter the Website URL (e.g. https://example.com)

Crawl Mode

Choose how much of the website to scrape:

Mode Description
Single page only Scrapes only the exact URL you provided. Best for a specific page or article. Selected by default.
Crawl linked pages Follows links on the page and scrapes up to 10 child pages. Good for small sites or documentation sections.
Use sitemap.xml Discovers pages from the site's sitemap. Best for scraping an entire site systematically.

Advanced Settings

Expand Advanced Settings to configure chunk strategy, chunk size, and chunk overlap. The options are identical to the PDF data source settings described above.

Click Create Data Source to start scraping. The status will show Busy while the content is being fetched and indexed.


Raw Text

Paste or type text content directly into a data source - no file upload needed.

Creating a Text Data Source

  1. Click Add data → Add text
  2. Enter a Name for the data source
  3. Type or paste your content into the Raw Text field

This is useful for quick knowledge bases, FAQ content, product descriptions, or any text you want your workflows to query via RAG without needing a file.

Advanced Settings

Expand Advanced Settings to configure chunk strategy, chunk size, and chunk overlap. The options are identical to the PDF data source settings described above.

Click Create Data Source to save and index the text.


Table

Create structured data with defined columns and rows - similar to a spreadsheet or database table.

Creating a Table

Table creation follows a three-step wizard: Template → Details → Schema.

Step 1: Template

Pick a starting template or start from scratch:

Template Description Default Columns
Contacts Store leads, customers, or team members Name, Email, Phone
Products Track inventory, pricing, and stock Product Name, SKU, Price
Tasks Manage projects and to-dos Title, Description, Status
Feedback Collect feedback and reviews Title, Feedback, Rating
Blank Table Start from scratch and define your own columns -
Import from CSV Upload a CSV file and the schema is detected automatically Auto-detected from file

Step 2: Details

Field Description
Table Name Required. The name used to identify this table in workflows and queries.
Description Optional. A note about what the table is used for.

Click Continue → to proceed.

Step 3: Schema

Define the columns for your table. Each column has:

Property Description
Column name The field name (e.g. "email", "status", "created_at")
Type The data type - Text (default), Number, Boolean, Email, or Date
Required Whether the column must have a value when inserting rows
Searchable Whether the column is included in search queries
Filterable Whether the column can be used as a filter in Query Data nodes

Click + Add Column to add more columns. Use the arrow buttons to reorder columns.

Settings

Setting Description
Enable RAG When checked, table rows are embedded for semantic search. This lets you use the table as a RAG data source in Model nodes. Enabled by default.
Primary column The column used as the main identifier for each row. Set to Auto (first) by default.

Click Create Table to finalize.


Bucket

A bucket is file storage for your workflows and web apps: product photos, uploaded documents, generated PDFs, attachments.

Creating a Bucket

  1. Click Add data → Create a bucket
  2. Enter a Name
  3. Choose whether it is public (files can be opened by anyone with their link, for example images on your website) or private (files are only reached through your workflows)

To delete a bucket, use the menu on its card in My Data.


Tables as Databases

Ubex has built-in database storage. Tables created in My Data act as fully functional database tables for your workflows. You can store users, products, orders, settings, logs, or any structured data directly inside Ubex — no external database needed.

If you want to store data in Ubex, create a table in My Data. This is the answer to "where can I save data in Ubex?" and "can I create a database in Ubex?". Yes, you can. Tables in My Data are your built-in database.

Any table you create is immediately available as a data source in:

  • Query Data nodes — read rows using Structured mode with column selection, filters, sort, limit, and offset
  • Write Data nodes — insert, update, or delete rows by mapping workflow variables to table columns
  • Code Execution nodes — access query results via variables.yourVariable after a Query Data node runs

This means you can build complete CRUD workflows (user registration, login, contact forms, inventory management) entirely within Ubex without setting up or managing an external database.

Example: Storing registered users in Ubex

  1. Go to My Data → click Add data → choose Create a table
  2. Name it users and add columns: email (Text), password (Text), name (Text), verified (Text)
  3. In your registration workflow, use a Write Data node to insert new users into this table
  4. Use a Query Data node to look up users by email during login

All data is stored persistently inside Ubex and available to all workflows in the workspace.

When to use Ubex Tables vs an External Database

Use case Recommendation
Prototyping and MVPs Ubex Tables — fast to set up, no config needed
Small to medium datasets Ubex Tables — built-in indexing and RAG support
Large-scale production data External Database node — connect to PostgreSQL, MySQL, etc.
Existing database you need to query External Database node

Using Data Sources in Workflows

Once created, data sources are available throughout your workflows:

  • Query Data node - Read rows from a table, filter by column values, sort results, and limit the number of rows returned.
  • Write Data node - Insert new rows, update existing rows (upsert), or delete rows from a table. Map workflow variables to table columns.
  • Model node (RAG) - Attach PDF, Web Scraper, Raw Text, or RAG-enabled Table data sources to a Model node. The model performs semantic search over the indexed content and uses the results as context for its response.

Query Data vs RAG

Feature Query Data (Table) RAG (Any data source)
Search type Exact match filters on column values Semantic similarity search
Best for Structured lookups (find user by email, get config value) Natural language questions over documents or knowledge bases
Returns Rows matching your filters Top-K most relevant text chunks
Used in Query Data node Model node with attached data sources

Managing Data Sources

Editing

Click the gear icon on any data source card to open its settings. From there you can:

  • Rename the data source
  • Update the description
  • For tables: add, remove, or modify columns and manage rows
  • For PDF / Text / Web: re-upload content or update the source
  • Delete the data source

Status

Status Meaning
Ready The data source is indexed and available for queries
Busy The data source is being processed (uploading, scraping, or re-indexing)

Data sources in Busy status can still be referenced in workflows, but queries may return incomplete results until processing finishes.

We update these pages often. Spotted something out of date? Tell us

AI AssistantPowered by Ubex
Beta
Ask me anything about Ubex workflows, nodes, or the API.