[InDesign Integration](https://factory.dev/our-bundles/pimcore-indesign-integration)

- [Docs](https://factory.dev/our-bundles/pimcore-indesign-integration/docs)
- [Release notes](https://factory.dev/our-bundles/pimcore-indesign-integration/releases)

[Request a demo](https://factory.dev/book-a-demo)

Get started

- [Requirements](https://factory.dev/our-bundles/pimcore-indesign-integration/docs/requirements)
- [Before installation: access and keys](https://factory.dev/our-bundles/pimcore-indesign-integration/docs/before-installation-access-and-keys)
- [Installation](https://factory.dev/our-bundles/pimcore-indesign-integration/docs/installation)
    - Install Pimcore InDesign bundle
    - Install Factory InDesign plugin
- [Upgrades](https://factory.dev/our-bundles/pimcore-indesign-integration/docs/upgrades)
- [Datahub configuration](https://factory.dev/our-bundles/pimcore-indesign-integration/docs/datahub-configuration)
- [Create the image thumbnail for the InDesign plugin](https://factory.dev/our-bundles/pimcore-indesign-integration/docs/create-the-image-thumbnail-for-the-indesign-plugin)
- [Licence validation](https://factory.dev/our-bundles/pimcore-indesign-integration/docs/licence-validation)

Using the plugin

- [Open the installed plugin](https://factory.dev/our-bundles/pimcore-indesign-integration/docs/open-the-installed-plugin)
- [Connect to Pimcore](https://factory.dev/our-bundles/pimcore-indesign-integration/docs/connect-to-pimcore)
- [Browse objects and assets](https://factory.dev/our-bundles/pimcore-indesign-integration/docs/browse-objects-and-assets)
- [Prepare a document and fill text frames](https://factory.dev/our-bundles/pimcore-indesign-integration/docs/prepare-a-document-and-fill-text-frames)
- [Place images and other files](https://factory.dev/our-bundles/pimcore-indesign-integration/docs/place-images-and-other-files)
- [Use related objects, repeated values, and galleries](https://factory.dev/our-bundles/pimcore-indesign-integration/docs/use-related-objects-repeated-values-and-galleries)
- [Check for updates](https://factory.dev/our-bundles/pimcore-indesign-integration/docs/check-for-updates)
- [Supported Pimcore data types](https://factory.dev/our-bundles/pimcore-indesign-integration/docs/supported-pimcore-data-types)

# Installation

By Mario Prša · Updated 19 Nov 2026

A developer installs the Pimcore InDesign bundle in the Pimcore project, then sends the InDesign plugin installation ZIP from the package to each person who will use the plugin (for example, a designer or product manager). That person installs the plugin on their own InDesign workstation. The developer needs access to the Pimcore project and server/deployment environment, the bundle package, and a code editor (for example, Visual Studio Code).

## Install Pimcore InDesign bundle

Run these six steps in the Pimcore project environment.

1. **Add the GitLab repository to Composer.** The bundle is hosted on GitLab rather than Packagist. Add this entry to the project’s `composer.json` under `repositories` (merge it with any existing entries rather than replacing them):

```
{
  "repositories": {
    "factory-indesign-bundle": {
      "type": "git",
      "url": "https://oauth2:<ACCESS-TOKEN>@git.byfactory.dev/factory/indesign-bundle.git"
    }
  }
}
```

Replace `<ACCESS-TOKEN>` with an authorized GitLab access token. Keep it secret; do not include a real token in screenshots or published documentation. Follow your project’s credential-handling practice.

2. **Install the bundle via Composer** in the Pimcore project:

```
composer require factory/indesign-bundle:^1.2
```

3. **Register the bundle if needed.** It should register automatically in `config/bundles.php`. If it does not, add this entry to the existing returned array:

```
<?php
// config/bundles.php
return [
    // ...existing bundles
    Factory\InDesignBundle\InDesignBundle::class => ['all' => true],
];
```

4. **Install the bundle:**

```
bin/console pimcore:bundle:install InDesignBundle
```

5. **Install bundle resources** so public JavaScript files are available in Pimcore Admin:

```
bin/console assets:install --symlink
```

The `--symlink` option creates symbolic links instead of copying files.

6. **Clear Symfony and Pimcore caches:**

```
bin/console cache:clear
bin/console pimcore:cache:clear
```

After completing all six steps, the developer finds the InDesign plugin installation ZIP in the package and sends that ZIP to each person who will use the plugin in their work (for example, a designer or product manager).

## Install Factory InDesign plugin

On their InDesign workstation, the person who will use the plugin:

1. Extracts the ZIP received from the developer and locates the `.ccx` plugin installation file in the extracted files.

2. Double-clicks the `.ccx` file to install the Factory InDesign plugin through Adobe Creative Cloud.

Before starting **Using plugin**, wait until **Datahub configuration**, **Create image thumbnail for InDesign plugin**, and **Licence validation** have all been completed. Obtain the GraphQL Endpoint URL, API Key, and Product Key from the person managing the Pimcore connection.

[← Before installation: access and keys](https://factory.dev/our-bundles/pimcore-indesign-integration/docs/before-installation-access-and-keys) [Upgrades →](https://factory.dev/our-bundles/pimcore-indesign-integration/docs/upgrades)

---

Source: https://factory.dev/our-bundles/pimcore-indesign-integration/docs/installation
