Import Content into JCR from JSON or CSV file

Installation

The ImportContentFromJson module can be installed like any standard Jahia module.

 

Prerequisites

• Jahia 8.x or later

• Access to the Jahia Administration / Modules interface

• Permissions to deploy modules on the platform

 

---

Option 1 — Install from Jahia Store (Recommended)

1. Open Jahia Administration

2. Navigate to Modules → Jahia Store

3. Search for Import Content from JSON or CSV

4. Click Install

5. Wait for the module to deploy automatically

Once installed, the module will be available inside jContent.

 

---

Option 2 — Install from a JAR file

1. Download the module .jar from the repository releases.

2. Go to Jahia Administration → Modules

3. Click Install module

4. Upload the .jar file.

5. Activate the module once it appears in the module list.

 

---

Option 3 — Install for Development

If you want to build and deploy the module locally:

git clone https://github.com/smonier/importContentFromJson.git
cd importContentFromJson
mvn clean install

The generated module will be available in:

target/importContentFromJson-*.jar

Deploy it in Jahia by copying it into:

$JAHIA_HOME/digital-factory-data/modules

Then restart Jahia or install it via the Modules administration interface.

 

---

Verify Installation

After installation:

1. Open jContent

2. Click Content Tools

3. Select Import Content From JSON

 

You should now see the import interface where you can upload a JSON or CSV file and create content automatically.

FAQ

 

What type of files can I import?

The module supports importing content from:

• JSON files

• CSV files (with field mapping)

Each entry in the file represents a content item that will be created in the Jahia repository.

 

---

Do the field names need to match the content type properties?

Yes.

The property names in the JSON or CSV file must match the property names of the selected Jahia content type.

Example:

{
  "jcr:title": "My Article",
  "teaser": "Short description",
  "date": "2024-11-01"
}

If a property does not exist in the content type, it will be ignored.

 

---

Can I import multiple content items at once?

Yes.

You can import multiple content items in a single file. Each object in the JSON array will create one content node.

Example:

[
  {"jcr:title": "Article 1"},
  {"jcr:title": "Article 2"},
  {"jcr:title": "Article 3"}
]

 

---

Can the module import images?

Yes.

Images can be imported using a URL reference.

Example:

{
  "image": {
    "url": "https://example.com/image.jpg"
  }
}

The module will download the image and create the corresponding asset in the Jahia repository.

 

---

Are multi-valued fields supported?

Yes.

You can import multi-valued properties such as tags or image lists using arrays.

Example:

{
  "j:tagList": ["AI", "Automation", "Innovation"]
}

 

---

Where are the imported nodes created?

All content is created under the base path you select before starting the import in the module UI.

 

---

What happens if a property is missing?

If a property is missing from the JSON or CSV file:

• The property will simply remain empty

• The node will still be created

However, mandatory properties defined in the content type must be present.

 

---

What happens if the JSON structure is invalid?

The import will fail.

Make sure your file:

• Is valid JSON

• Contains a JSON array

• Uses valid property names

You can validate your JSON with tools such as:

• https://jsonlint.com

 

---

Can I use this module for content migration?

Yes.

The module is well suited for:

• Migrating content from external systems

• Importing datasets

• Bulk creating content for catalogs, articles, or news

• Seeding demo environments

 

---

Is the module safe to use in production?

Yes, but it is recommended to:

• Test imports in a staging environment first

• Validate the JSON structure before importing

• Import small batches when working with large datasets