# Import from Polotno

> Import your Polotno Studio designs into Orshot Studio

- **URL**: https://orshot.com/docs/importing-templates/import-from-polotno

---

If you've been using Polotno Studio for design work, you can import your templates directly into Orshot Studio. This allows you to migrate existing Polotno projects to take advantage of Orshot's API-driven image generation.

> **Ownership Notice**: By importing a design, you confirm that you have the rights to use it and accept responsibility for any copyright issues.

## How to Import

### 1. Open your design in Polotno Studio

Go to Polotno Studio and open the design you want to export.

### 2. Export as JSON

1. Click on the **File** menu (or the menu icon)
2. Select **Save as JSON** or **Export JSON**
3. Copy the entire JSON content

Alternatively, if you have the Polotno JSON stored locally, open the `.json` file and copy its contents.

### 3. Open Orshot Studio

Go to [Orshot Studio](https://orshot.com/studio) and click **+ New Template**.

### 4. Choose "Import from Polotno"

In the new template dialog, select the **Import from Polotno** option.

### 5. Paste the JSON

Paste your Polotno JSON into the text area. The importer will validate the JSON and show you:

- Template name
- Number of pages
- Any missing fonts that need to be uploaded

### 6. Import the template

Review the validation results and click **Import Template** to create your Orshot template.

## What Gets Imported

The Polotno importer translates:

- **Text elements** — with font family, size, weight, color, alignment, line height, and letter spacing
- **Images** — including photos and uploaded images
- **SVG elements** — converted to images with color replacements applied
- **Shapes** — rectangles, circles, and other basic shapes
- **Lines** — with stroke color and width
- **Background colors** — page backgrounds are preserved
- **Multi-page designs** — all pages are imported

## Element Translation

Polotno elements are automatically mapped to Orshot's element structure:

| Polotno Type      | Orshot Type             |
| ----------------- | ----------------------- |
| `text`            | `text`                  |
| `image`           | `image`                 |
| `svg`             | `image` (with SVG data) |
| `figure` (rect)   | `rectangle`             |
| `figure` (circle) | `circle`                |
| `line`            | `line`                  |

## Automatic Parameterization

All text and image layers are automatically configured for API use:

- Each text element gets a `parameterId` like `text_1_1`, `text_1_2`, etc.
- Each image element gets a `parameterId` like `img_1_1`, `img_1_2`, etc.
- All parameterized elements are added to the page's modifications list
- You can immediately use the API to dynamically change content

## SVG Color Handling

If your Polotno design uses SVGs with custom colors (via `colorsReplace`), Orshot will:

1. Apply the color replacements to the SVG
2. Convert the colored SVG to an image element
3. Preserve the visual appearance of your design

## Limitations

> Some Polotno features may require adjustment after import:

- **Polotno-specific elements** — Some specialized Polotno elements may not have direct equivalents
- **Complex SVG paths** — Very complex SVGs may be simplified
- **Custom fonts** — Fonts not available in Google Fonts need to be uploaded to Orshot
- **Effects and filters** — Advanced effects may not translate
- **Animations** — Not supported in Orshot

## Tips for Best Results

1. **Use Google Fonts** — These work seamlessly in both platforms
2. **Simplify complex designs** — Break down very complex layouts if needed
3. **Upload missing fonts** — Check the validation warnings and upload any missing fonts to Brand Assets
4. **Review after import** — Check element positioning and make minor adjustments as needed

## Troubleshooting

### Invalid JSON Error

If you see an "Invalid Polotno JSON" error:

- Ensure you copied the complete JSON (not truncated)
- Verify the JSON has a `pages` array at the root level
- Check that the JSON is properly formatted

### Missing Fonts

If fonts appear incorrect after import:

1. Note the missing fonts listed in the validation warning
2. Go to **Brand Assets** in Orshot
3. Upload the font files (.ttf, .otf, or .woff2)
4. Re-import or manually update the font in the template

### Images Not Loading

If images appear broken:

- Ensure the original images are still accessible at their URLs
- For base64 images, the importer will attempt to upload them to your Brand Assets
- Large designs may take a moment to process all images