# What you should know before embedding

Embedding supports app-in-app capability and allows integration of Tellius components (Search, Vizpads, Insights) into another application.

### **Benefits of embedding** <a href="#benefits_of_embedding" id="benefits_of_embedding"></a>

* Enables white labeling
* Facilitates unlimited customization as per unique requirements
* Promotes reusability and adoption
* Native apps can be powered by Tellius engines

## **Types of embedding** <a href="#types_of_embedding" id="types_of_embedding"></a>

Tellius provides two types of embedding:

1. via embedding URL
2. via backend APIs

### **Embedding URL**

Using the iFrame method, users can embed Tellius as part of another application. Here's how it works:

* The embedding URL for different components will be available on Tellius platform.
* Copy and code the URL into the required page.
* Tellius interface will be retained in the embedding app.
* The embedding app and Tellius communicate via postMessages. For every activity, the embedding app needs to send a request to Tellius, and Tellius will send the response.&#x20;

#### **Choose embedding URLs if you need to,**

* Visualize results in Tellius interface
* Cut down time and effort on development

### **APIs**

In this method, Tellius provides you with the backend APIs for different functionalities. Tellius interface is not retained, and users are free to create their own UI. APIs call for more technical expertise.

#### **Choose APIs if you need,**

* To develop own UI using Tellius APIs
* More customization and control over your interface

## **Performing actions on embedded Tellius** <a href="#performing_actions_on_embedded_tellius" id="performing_actions_on_embedded_tellius"></a>

Once Tellius is embedded into an app, the required actions can be performed from the Tellius interface. If not (in situations where only individual components are embedded), please make use of actionTypes provided for each Tellius component that is communicated via postMessage.

## **Glossary** <a href="#glossary" id="glossary"></a>

* **iFrame** - An inline frame (iframe) is an HTML element that embeds an HTML page within another app.&#x20;
* **postMessage()** - A browser API that facilitates secure communication between Tellius and the embedding app.
* **utm\_source -** A unique identifier added to embedding URLs, generated by Tellius. It helps control permissions, access levels, and tracks the context of the embedded content (like Vizpads, Insights, or Search).\
  It ensures that the right data, filters, and settings are applied when loading embedded components. Unlike security tokens (e.g., JWT), *utm\_source* is a random code used for context, not for authentication.

## **Limitations** <a href="#limitations" id="limitations"></a>

* For now, embedding of individual components (search bar, query results panel, list views) is not available.

## **Troubleshooting** <a href="#troubleshooting" id="troubleshooting"></a>

1. If you have any trouble with the embedding, go to the browser and open developer tools (or press F12).
2. Click on the **Console** tab and check for any page loading errors.
3. If the following error is found, then the cross-domain (CORS) setting is incorrect.

```
No 'Access-Control-Allow-Origin' header is present on the requested resource.
```

Please reach out to the Tellius support team for assistance.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.tellius.com/tellius-6.1/embedding-tellius/what-you-should-know-before-embedding.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.