Skip to content

Home

Jump to bottom
AZIRAR Mhamed (SNCF / DGA NUMERIQUE / e.SNCF Sol.D2D DDSP IDFCE) edited this page Apr 22, 2026 · 5 revisions

User Documentation | Nodify Headless CMS

Nodify is a powerful, flexible, and open source headless CMS designed to let you create and manage your content efficiently. With built-in i18n (multilingual) support, a robust API, and intuitive content management tools, Nodify empowers both technical and non-technical users.

This document will guide you through the main features of Nodify.

1. Initial Login and License Update

Default Credentials

Field Value
Username / Email admin@nodify.app
Password Admin13579++

⚠️ Security Tip: Change your default password after your first login.

2. Main Interface and Configuration

Dashboard

The main interface provides an overview of your content and various configuration options.

User Management

  • Create and manage users
  • Define their roles (admin, editor, viewer, etc.)
  • Assign specific access permissions to certain nodes

Language Management (i18n)

  • Configure the languages supported by your site
  • Manage translations for global audiences
  • Support for multilingual SEO

3. Content Structure: Nodes

What Are Nodes?

Nodes are the basic building blocks of your content structure. They can contain different types of content:

  • Text
  • HTML
  • JSON
  • Images
  • Files
  • CSS / JavaScript

Hierarchy

You can create a hierarchy of nodes to organize your content logically (e.g., Blog > Articles > 2024).

Visibility

A node being edited (SNAPSHOT state) or one of its contents will only be visible when it is deployed (PUBLISHED state).

Metadata

Associate metadata (key/value pairs, tags) with your nodes to facilitate searching and filtering.

Creating a Node

  1. Go to "My projects" in the menu
  2. Click on the "+" button
  3. Enter a name and select a default language (other fields are optional)
  4. Sub-nodes are added in the same way

Best Practices & Recommendations

💡 Pro Tip: Create a node for a specific content type or category.

Example for a blog:

  • Create a blog node
  • Create a sub-node for HTML/JSON content
  • Create a separate sub-node for images

A blog template is provided in this repository: AZIRARM/nodify-templates. Import it and examine how the nodes are organized.

Custom Data

On each node and each content, you have the option to add custom data (key/value pairs) accessible in the content via the keyword:

$value(CODE_VALUE)

Translations (i18n)

On each node and each content, you have the option to add word translations (key/value pairs and language code) accessible in the content via the keyword:

$trans(CODE_MESSAGE)

Management Rules

On each node and each content, you have the option to add management rules by clicking on "Rules":

Rule Type Action
Boolean Enable / Disable
Date Enable / Disable

Important:

  • If a node is disabled and the rule is enabled, the node, its sub-nodes, and all their contents will be inaccessible.
  • If a content is disabled, only that content will be disabled.

Data Inheritance

For values and translations, a content can access the translations and values of its parent nodes. This creates a powerful inheritance chain for multilingual content.

Deployment (SNAPSHOT vs. PUBLISHED)

State Description Visibility
SNAPSHOT Draft / under editing Only visible in admin interface
PUBLISHED Live / deployed Visible to public and tracked in analytics

Deployment Process:

  1. Click the "Deploy" button to publish a node or content
  2. As soon as a change is made, the state changes to SNAPSHOT
  3. The deployed SNAPSHOT version is saved

Status Indicators:

  • 🟢 Green – Deployed (PUBLISHED)
  • 🟠 Orange – Being modified (SNAPSHOT with changes)
  • 🔴 Red – Just created (never deployed)

Version History

  • Click the small colored button on the left to access version history
  • All previous versions will appear
  • You can revert to an earlier version
  • ⚠️ Use version rollback sparingly to avoid data loss

Deletion

Soft Delete:

  • Click the "Delete" button in the "Actions" column
  • The content/node is moved to trash (not permanently deleted)

Permanent Delete:

  • Click the trash can icon at the top
  • Choose: permanently delete OR cancel deletion
  • ⚠️ Deleting a node deletes all its sub-nodes and their contents

Content Creation

To create content on a node or sub-node:

  1. First create at least one node
  2. Go to the line of the concerned node
  3. Click on "Contents"
  4. A window displaying the node's contents will open
  5. Create contents of different types (text, HTML, JSON, etc.)

4. Content Creation and Management

Content Types

Create different content types (articles, pages, products, etc.) by defining the fields and properties specific to each type.

Content Editing

Modify the content of your nodes directly in the interface using:

  • WYSIWYG editor (visual editing)
  • Code editor (HTML, JSON, CSS, JS)

Translation Management (i18n)

Translations are managed at both the node and content levels:

  • Translate metadata fields
  • Translate the content itself
  • Support for unlimited languages

5. Advanced Features

Multilingualism (i18n)

Nodify is fully multilingual. You can create translated versions of your content for different markets, with language-specific slugs and URLs for better international SEO.

Workflows

Implement approval workflows to validate content changes before publication.

Integrations

Integrate Nodify with other tools and services:

  • CRMs (Salesforce, HubSpot)
  • E-commerce platforms (Shopify, Magento)
  • Marketing automation tools
  • Mobile apps (via REST API)

CaaS (Content as a Service)

Nodify is fully compatible with CaaS architecture, allowing you to publish content once and distribute everywhere:

  • Websites
  • Mobile apps (iOS, Android)
  • Email campaigns
  • IoT devices

6. Analytics

Nodify provides built-in analytics for PUBLISHED content only:

Metric Description
Impressions Number of content views
Clicks Number of clicks on content
User Feedback Ratings and comments

📊 Marketing Tip: Use analytics data to identify top-performing content and optimize underperformers.

7. Security

Access Control

  • Configure permissions precisely for each user
  • Protect sensitive content with role-based access

Backups

  • Regularly back up your content to prevent data loss
  • Version history provides additional protection

8. Support

For any questions or problems, please contact our support team.

9. Developer Notes

API Guidelines

  • When adding content via the API, it is recommended to append the request parameter status=SNAPSHOT to URLs for nodes and contents
  • Upon publication, nodes and contents automatically switch to status=PUBLISHED
  • Versions always remain in SNAPSHOT

Analytics Rules

  • Analytics only apply to nodes and contents that are in the PUBLISHED state

Access Rules via API

To access a node or content from the API, both the node/content itself AND all its parent nodes must be published. Otherwise, the API will return a 404 error.

Conclusion

This document has provided you with an overview of Nodify's features. As an open source headless CMS with i18n support, a powerful API, and CaaS capabilities, Nodify gives you complete control over your content. For more in-depth usage, explore the various options offered by the platform.

#Nodify #HeadlessCMS #OpenSource #ContentManagement #SNAPSHOT #PUBLISHED #API #Analytics #DeveloperGuide #CMS #Documentation #i18n #Multilingual #CaaS #ContentAsAService #UserGuide

Clone this wiki locally