PHPackages                             matrixcreate/contentiq-craft-import - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. matrixcreate/contentiq-craft-import

ActiveCraft-plugin[Utility & Helpers](/categories/utility)

matrixcreate/contentiq-craft-import
===================================

Import ContentiQ content exports into Craft CMS 5 entries.

1.10.0(2w ago)019↓100%MITPHPPHP >=8.2

Since Apr 24Pushed 2w agoCompare

[ Source](https://github.com/MatrixCreate/contentiq-craft-import)[ Packagist](https://packagist.org/packages/matrixcreate/contentiq-craft-import)[ Docs](https://github.com/MatrixCreate/contentiq-craft-import)[ RSS](/packages/matrixcreate-contentiq-craft-import/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (10)Dependencies (1)Versions (22)Used By (0)

ContentIQ Craft Import
======================

[](#contentiq-craft-import)

Craft CMS 5 plugin that imports [ContentiQ](https://contentiq.io) content into published Craft entries — via JSON file upload or live API sync.

Requirements
------------

[](#requirements)

- Craft CMS 5.0+
- PHP 8.1+

Installation
------------

[](#installation)

```
composer require matrixcreate/contentiq-craft-import
php craft plugin/install contentiq-importer
```

Configuration
-------------

[](#configuration)

Add `config/contentiq.php` to your Craft project:

```
return [
    'section'     => 'pages',       // Entry section handle
    'entryType'   => 'pages',       // Entry type handle
    'assetVolume' => 'images',      // Asset volume for imported images
    'assetFolder' => 'contentiq',   // Folder within the volume
    'matrixField' => 'contentBlocks',
    'seoField'    => 'seo',
];
```

All keys are optional — the values above are the defaults.

Add API credentials to `.env`:

```
CONTENTIQ_URL=https://your-contentiq-instance.com
CONTENTIQ_API_KEY=ciq_your-project_xxxxxxxxxxxxxxxxxxxxxxxxxxxx

```

Then reference them in the plugin settings (CP → Settings → ContentIQ Importer).

Usage
-----

[](#usage)

### CLI import

[](#cli-import)

```
php craft contentiq-importer/import --file=export.json
php craft contentiq-importer/import --file=export.json --dry-run
php craft contentiq-importer/import --file=export.json --verbose
```

- `--dry-run` validates and reports without writing anything or downloading assets
- `--verbose` logs each block and image as it's processed

### CP import

[](#cp-import)

Navigate to **ContentiQ** in the Craft control panel. Upload a JSON export file, review the dry-run preview, then confirm to import.

### API sync

[](#api-sync)

Use the **Sync** tab in the CP to pull all pages from the ContentiQ API in one operation. Runs via Craft's queue — the UI polls for completion and shows a hierarchical report when done.

### Per-entry sync

[](#per-entry-sync)

Each entry edit screen shows a **CONTENTIQ** sidebar widget with:

- **Sync** — pulls and re-imports just this entry from the API
- **Lock** — prevents this entry from being overwritten during batch syncs
- **Notes** — developer notes attached to content blocks in ContentiQ

Local development
-----------------

[](#local-development)

To develop the plugin and a Craft project simultaneously, run from the Craft project root:

```
# Switch to local symlinked copy
composer config repositories.contentiq '{"type":"path","url":"../contentiq-craft-import","options":{"symlink":true}}' \
  && composer require matrixcreate/contentiq-craft-import:@dev

# Revert to Packagist
git checkout composer.json composer.lock && composer install
```

Never commit the path repository — the `git checkout` step ensures `composer.json` is clean before pushing.

Releasing
---------

[](#releasing)

Always pair a git tag with a GitHub release:

```
git tag 1.x.0
git push origin main --tags
gh release create 1.x.0 --title "1.x.0" --notes "- What changed"
```

Further reading
---------------

[](#further-reading)

See [PLUGIN-SPEC.md](PLUGIN-SPEC.md) for a full technical reference covering the import pipeline, JSON format, block mapping system, API endpoints, and database schema.

###  Health Score

44

—

FairBetter than 90% of packages

Maintenance96

Actively maintained with recent releases

Popularity9

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity55

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~1 days

Total

21

Last Release

18d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/115574974?v=4)[BenHMatrix](/maintainers/BenHMatrix)[@BenHMatrix](https://github.com/BenHMatrix)

---

Top Contributors

[![BenHMatrix](https://avatars.githubusercontent.com/u/115574974?v=4)](https://github.com/BenHMatrix "BenHMatrix (41 commits)")

---

Tags

plugincontentimportcmsCraftcontentiq

### Embed Badge

![Health badge](/badges/matrixcreate-contentiq-craft-import/health.svg)

```
[![Health](https://phpackages.com/badges/matrixcreate-contentiq-craft-import/health.svg)](https://phpackages.com/packages/matrixcreate-contentiq-craft-import)
```

###  Alternatives

[spicyweb/craft-neo

A Matrix-like field type with block hierarchy

393808.8k10](/packages/spicyweb-craft-neo)[craftcms/feed-me

Import content from XML, RSS, CSV or JSON feeds into entries, categories, Craft Commerce products, and more.

294943.4k27](/packages/craftcms-feed-me)[verbb/formie

The most user-friendly forms plugin for Craft.

100387.6k57](/packages/verbb-formie)[verbb/navigation

Create navigation menus for your site.

92698.4k18](/packages/verbb-navigation)[verbb/workflow

Enforce multi-step review processes for creating entries.

138123.0k1](/packages/verbb-workflow)[verbb/comments

Add comments to your site.

13753.7k](/packages/verbb-comments)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)