# Layouts

Layouts are the foundation for generating images in Squarebox. A layout acts as a **template** where placeholders for variable data (like names, details, or contact information) are pre-defined. Users can select or create layouts before generating dynamic images.

Layouts allow businesses to maintain **design consistency** and **flexibility** while personalizing content for campaigns, promotions, or events.

#### **Key Features**

* **Pre-Defined Templates**: Use ready-made layouts for common use cases.
* **Dynamic Variables**: Placeholders for customer-specific data such as `{{name}}`, `{{location}}`, or `{{price}}`.
* **Custom Layout Creation**: Upload or create layouts tailored to your specific requirements.
* **Preview Option**: View a sample layout to check placement and formatting.
* **Layout Types**: Supports various formats like **images, documents, and videos**.

<figure><img src="/files/UvPLBStPmbel9VufaInJ" alt=""><figcaption></figcaption></figure>

#### **Types of Layouts**

1. **Document Layouts (Beta)**:
   * Use Case: Event passes, ID cards, or certificates.
   * Example: Generate event tickets with attendee names, QR codes, and event details.
2. **Image Layouts**:
   * Use Case: Promotional banners, real estate listings, or car advertisements.
   * Example: Property images with price, location, and contact details.
3. **Video Layouts** **(Beta)**:
   * Use Case: Dynamic video generation for announcements or personalized ads.
   * Example: Short videos with customized names and product highlights.

#### **Steps to Manage Layouts**

1. **View Existing Layouts**:
   * Navigate to the **Layouts** section under **Image Generation**.
   * View and select active layouts for your campaigns.
2. **Customize or Upload Layouts**:
   * Choose an existing layout or work with the Squarebox support team to create custom layouts tailored to your needs.
3. **Preview Layout**:
   * Click **View Layout** to preview placeholder fields and formatting.

***

#### **Use Cases for Layouts**

1. **Event Management**: Layouts for event tickets, passes, or badges.
2. **Automobile Sales**: Layouts for car promotions with make, model, and price details.
3. **Real Estate**: Layouts for property banners, floor plans, and pricing.
4. **Marketing Campaigns**: Templates for festive promotions or targeted advertisements.
5. **Corporate Documents**: Layouts for ID cards or certificates.


---

# 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://squarebox-ai.gitbook.io/squarebox/media-library/layouts.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.