Skip to content
Snippets Groups Projects
x-rays.md 3.44 KiB
Newer Older
  • Learn to ignore specific revisions
  • ---
    title: X-rays
    
    redirect_from:
      - /docs/latest/users-guide/14-x-rays
    
    # X-rays
    
    Maz Ameli's avatar
    Maz Ameli committed
    
    
    X-rays are a way to get automatic insights and explorations of your data.
    
    ## Get automatic insights when clicking on a chart
    
    One great way to explore your data in general in Metabase is to click on points of interest in charts and selecting **Automatic insights**.
    
    ![Automatic insights in the drill-through menu](./images/automatic-insights.png)
    
    Maz Ameli's avatar
    Maz Ameli committed
    
    
    Metabase will give you some options:
    
    - **X-ray**
    - **Compare to the rest**
    
    Maz Ameli's avatar
    Maz Ameli committed
    
    
    In both cases, Metabase will take a look at the fields in that table or model, and automatically generate charts that summarize the data based on the data types it finds.
    
    Here's an example X-ray:
    
    ![Example X-ray of the products table](./images/x-ray-example.png)
    
    ## X-raying models and tables
    
    ![Browse data X-ray](./images/browse-data-x-ray.png)
    
    Another great way to get to know your data is by X-raying your models and tables.
    
    - **Table X-rays**: From the left nav, click on **Browse Data**, pick a database, hover over a table card, and click the lightning bolt icon table to view an X-ray of the table.
    - **Model X-rays**: Click on the ellipses for a model and select **X-ray this**.
    
    ## X-rays in the data reference
    
    You can also view an X-ray by browsing to a table and clicking on the lightning bolt icon. Click on the **Browse Data** button in the top navigation, select a database, and hover over a table to see the icon.
    
    
    From the Browse Data page, you can also click on `Learn about our data` to view the Data Reference section. From here you can navigate through databases, tables, columns, metrics, or segments, and you can click on the X-ray link in the left sidebar to see an X-ray of the item you're currently viewing.
    
    ![Data Reference X-ray](./images/data-reference.png)
    
    ## Exploring newly added data sources
    
    If you're an administrator, when you first connect a database to Metabase, Metabot will offer to show you some automatic explorations of your newly connected data.
    
    ## Browsing through suggested X-rays
    
    Maz Ameli's avatar
    Maz Ameli committed
    
    
    Depending on the X-ray you're currently viewing, you'll see suggestions that will let you:
    
    Maz Ameli's avatar
    Maz Ameli committed
    
    
    - **Zoom out**: view an X-ray of the table the current X-ray is based on.
    - **Zoom in**: see a more detailed X-ray about a field or dimension of the current X-ray.
    - **Related**: X-ray some related data, like a metric based on the current table, or a different table related to the current one.
    
    Maz Ameli's avatar
    Maz Ameli committed
    
    
    ## Saving X-rays
    
    If you come across an X-ray that's particularly interesting, you can save its cards and filters as a dashboard by clicking the green **Save this** button. Metabase will create a new dashboard and save it to the Automatically generated dashboards collection (though you can move the dashboard to any collection you have curate access to).
    
    ## Disabling X-rays
    
    If for some reason X-rays aren't a good fit for your team or your data, administrators can turn them off completely by clicking on the gear icon in the upper right and going to **Admin settings** > **Settings** > **General** and toggling the option to **Enable X-ray features**.
    
    If you pin any dashboards in the "Our Analytics" collection, Metabase will hide the X-ray suggestions that appear on the homepage.
    
    Admins can also manually remove these suggestions by clicking on the **Customize** button in the upper right and selecting a dashboard as your homepage. [Changing the home page](../configuring-metabase/settings.md#custom-homepage) won't disable the X-ray features in the rest of Metabase.