> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omni.co/llms.txt
> Use this file to discover all available pages before exploring further.

<AgentInstructions>

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:

POST https://docs.omni.co/feedback

```json
{
  "path": "/modeling/develop/guides/model-ide",
  "feedback": "Description of the issue"
}
```

Only submit feedback when you have something specific and actionable to report.

</AgentInstructions>

# Developing in Omni: Model IDE

> Navigate the Omni Model IDE to edit auto-generated schema files, define views and fields, and manage your data model structure.

Omni works on your behalf to understand how to navigate your database. This allows for both accelerated initial deployments and long term scalability as the underlying schema changes.

You will notice that several files are automatically generated when you connect your database and initialize a data model. This section will walk through the different types of files in the model and orient you on how to use them.

<Steps>
  <Step title="Model IDE basics">
    <iframe className="w-full aspect-video rounded-xl" src="https://www.loom.com/embed/fdae6a555f3f483ebc19702983058e7b?sid=90946948-ae4b-404d-9874-4a2d3d3d637e" title="Model IDE basics" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />

    Start with learning about the key features of Omni's modeling IDE, which offers powerful tools for managing data models at scale.

    **In this video, you'll learn about:**

    * **Files in the IDE**, such as [models](/modeling/models), [relationships](/modeling/relationships), [topics](/modeling/topics), and [views](/modeling/views)
    * **Development tools** such as [branching](/content/develop/branch-mode) and [version control](/modeling/develop/history)
    * [**The content validator**](/modeling/develop/content-validator), which identifies and fixes errors across dashboards and workbooks
    * [**The dbt IDE**](/integrations/dbt/models), which provides a read-only view of dbt projects

    <Tip>
      If you have connection access permissions, you can navigate directly to connection settings from any model IDE page by clicking **Model** in the top navigation and selecting **Go to connection**. This opens the connection settings page in a new tab.
    </Tip>
  </Step>

  <Step title="Model files">
    <iframe className="w-full aspect-video rounded-xl" src="https://www.loom.com/embed/82cd1bedacd44bdaa906f84b6bb2fea0?sid=c787bf96-d5ce-450f-8bd6-f3cbff13d6e9" title="Model files" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />

    Explore the powerful customization options within Omni's [model file](/modeling/models) to curate experiences for your end users. Model files are used to define configuration for the analytical environment (topics, views, and so on) associated with a specific connection.

    **In this video, you'll learn to**:

    * Streamline navigation and reduce complexity by including and excluding schemas, views, and fields
    * Utilize [access grants](/modeling/develop/data-access-control) to restrict user access to topics and fields based on [user attributes](/administration/users/attributes)
    * Balance performance and data freshness with [caching policies](/analyze-explore/performance/caching)
  </Step>

  <Step title="Relationships file">
    <iframe className="w-full aspect-video rounded-xl" src="https://www.loom.com/embed/337adf9b5a8d40ec93e6ac7f4554eb04?sid=15d06cf9-198b-41f9-b737-cbcd21021df3" title="Relationships file" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />

    Enable your users to explore data without fear of disruption by utilizing the [relationship management file](/modeling/relationships). In this file, you can pre-define joins and automatically propagate them to workbook queries, thus removing the need for manual updates.

    **In this video, you'll learn to:**

    * Define relationships between tables using Omni's YAML syntax and [the workbook](/modeling/relationships/build)
    * Specify [relationship types](/modeling/relationships/parameters/relationship-type) and [direction](/modeling/relationships/parameters/reversible)
    * Create advanced custom joins with [SQL logic](/modeling/relationships/parameters/on-sql), [table aliases](/modeling/relationships/parameters/join-to-view-as), and [filters](/modeling/relationships/parameters/where-sql)
  </Step>

  <Step title="View files">
    <iframe className="w-full aspect-video rounded-xl" src="https://www.loom.com/embed/68728244c832413d902b946c996d5f51?sid=0f367af0-0c88-4db4-9035-91981b5ef1c4" title="View files" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />

    Define what users see when accessing tables in the workbook by customizing the table's [view file](/modeling/views).

    **In this video, you'll learn to:**

    * Improve discovery with metadata such as [labels](/modeling/views/parameters/label), descriptions, [tags](/modeling/views/parameters/tags), and field groups
    * Refine the data by adding filters and including or excluding specific fields
    * Encourage deeper exploration with [drill fields](/modeling/views/parameters/default-drill-fields)
  </Step>

  <Step title="Topic files">
    <iframe className="w-full aspect-video rounded-xl" src="https://www.loom.com/embed/e59dfa741e9a45929933ab8562ce3c2c?sid=ac064c06-606f-4f11-bb13-2bc7841641cf" title="Topic files" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />

    Curate an entire dataset by using [topics](/modeling/topics), which allow you to organize and structure data around a specific area of interest or analysis.

    **In this video, you'll learn to:**

    * Refine the dataset by specifying which [tables](/modeling/topics) and fields to include
    * Define pre-configured [filters](/modeling/topics/parameters/default-filters) to apply to workbook queries
    * Improve [Blobby AI's](/ai/security) understanding of the topic by providing [context](/modeling/topics/parameters/ai-context)
  </Step>
</Steps>