## App registration

URL: https://docs.atlan.com/product/capabilities/build-apps/references/register-app

> Configure iframe URL, allowed origins, and where the app appears (sidebar, asset tabs, conditional rules).

Configure where your embedded app appears in Atlan by registering iframe URL, allowed origins, and render locations — display as a sidebar navigation tab, asset profile tab, or both with conditional rendering rules. Verify your app is deployed and has authentication set up to receive user context (see [Embed your app](https://docs.atlan.com/llms/platform/build-apps/embed-in-atlan/llms.txt) if needed), then use this reference to configure display name, icons, and conditional asset type rendering.

## Configuration object

```json
{
 "app-id": {
 "display_name": "App Display Name",
 "iframe_url": "https://your-app.example.com",
 "allowed_origins": ["https://your-app.example.com"],
 "icon": "Analytics",
 "description": "Brief description of your app",
 "company": "Company name",
 "render_at": [{ "slot": "nav-tab" }]
 }
}
```

## App fields

## Render locations

`render_at` is an array of objects. Each object specifies a `slot` and, for conditional slots, an optional `when` clause.

### Slots

<!-- vale Microsoft.Quotes = NO -->

<!-- vale Microsoft.Quotes = YES -->

### Conditional rendering (`when`)

Use `when` to control where the `asset-profile-tab` appears.

## Examples

### Sidebar app

```json
{
 "analytics-dashboard": {
 "display_name": "Analytics",
 "iframe_url": "https://analytics.example.com",
 "allowed_origins": ["https://analytics.example.com"],
 "icon": "Analytics",
 "description": "View platform analytics",
 "render_at": [{ "slot": "nav-tab" }]
 }
}
```

### Asset profile tab (tables and views)

```json
{
 "data-quality": {
 "display_name": "Data Quality",
 "iframe_url": "https://dq.example.com",
 "allowed_origins": ["https://dq.example.com"],
 "icon": "Quality",
 "description": "View data quality metrics",
 "render_at": [
 {
 "slot": "asset-profile-tab",
 "when": {
 "assetTypes": ["Table", "View", "MaterialisedView"]
 }
 }
 ]
 }
}
```

### Multiple slots

```json
{
 "multi-location-app": {
 "display_name": "My App",
 "iframe_url": "https://myapp.example.com",
 "allowed_origins": ["https://myapp.example.com"],
 "icon": "Apps",
 "render_at": [
 { "slot": "nav-tab" },
 {
 "slot": "asset-profile-tab",
 "when": { "assetTypes": ["Table", "Column"] }
 }
 ]
 }
}
```

## See also

- [Embed your app](https://docs.atlan.com/llms/platform/build-apps/embed-in-atlan/llms.txt): Configure iframe embedding and authentication
- [Connection and authentication issues](https://docs.atlan.com/llms/platform/build-apps/connection-and-authentication-issues/llms.txt): Troubleshoot registration and embed failures
- [Embedded apps security FAQ](https://docs.atlan.com/llms/platform/build-apps/embedded-apps-security/llms.txt): Common security questions

---