Skip to content
VivrealDocs

Managing Objects

Create, edit, delete, and organize content objects within your collections

beginner8 min readFor portal users

Managing Objects

Objects are the individual content entries within a collection. Once your collection has a schema, you can start creating, editing, and organizing objects.

Viewing Objects

Navigate to Content in the bottom navigation bar and tap a collection. The object list displays all entries, with columns matching the fields defined in your schema.

From the object list, you can:

  • Sort by any column (click the column header)
  • Search for objects using the search bar
  • Filter by tags or field values
  • Switch views between table and card layouts

Creating an Object

Open the collection

Navigate to the collection where you want to add content.

Click + New Object

Click the + New Object button in the top-right corner. This opens the object editor — a form generated from your collection's schema.

Fill in the fields

The form displays an input for each field in your schema. Fill in your content:

  • Short Text renders as a text input
  • Structured / Long Text opens a rich text editor with formatting toolbar
  • Whole Number / Decimal Number render as numeric inputs
  • Date / Date & Time / Time show the appropriate picker
  • Custom Choices show a dropdown of predefined options
  • True / False renders as a toggle
  • Image / Video / File Upload display an upload area (see Media Uploads)
  • List of Items lets you add multiple values
  • Color shows a color picker
  • Variant Field shows per-variant inputs for the fields it affects

Required fields are marked with an asterisk (*). The form won't submit until all required fields are filled.

Save the object

Click Save to create the object. It appears immediately in the object list and is available via the Client API for your deployed sites.

Editing an Object

Click on any object in the list to open it in the editor. Make your changes and click Save. The update is persisted immediately.

Vivreal keeps a version history of your objects. If you need to undo a change, open the Version History drawer from the object editor to view previous versions and revert if needed.

Deleting an Object

To delete an object:

  1. Click the menu icon (three dots) on the object row or open the object detail view.
  2. Select Delete.
  3. Confirm the deletion in the dialog.

Deletion is permanent. The object is removed from the collection and will no longer appear on your deployed sites.

Deleting an object also removes any associated media files from storage. Make sure you don't need the files before confirming.

Version History

Every time you update an object, Vivreal saves a version snapshot. You can:

  • View the full history of changes in the Version History drawer
  • See a diff comparing any two versions side by side
  • Revert to a previous version with one click

The number of versions retained depends on your group's tier plan. Older versions are automatically pruned when the limit is reached.

Tips for Content Management

  • Use tags generously — tags make it easy to filter and find objects later, especially in large collections.
  • Fill in all required fields — incomplete objects can cause display issues on your site.
  • Preview on your site — after saving changes, check your deployed site to see how the content renders in your template.
  • Use Structured / Long Text wisely — the rich text editor supports headings, lists, links, bold, italic, and more. Keep formatting consistent across objects for a professional look.

Next Steps

If your collection has media support enabled, learn about uploading files and managing media.