Getting Started

Your first project

Everything in Svalla starts with a project. A project represents a single website or application and contains all its content, templates, media, users, and settings.

To create a project:

• Log into the Svalla back-office
• Click "New Project" from the dashboard
• Enter a project name and URL
• Choose your project mode (Development, Staging, or Production)

You can manage multiple projects from the same Svalla installation, each with its own content, users, and configuration.

Set up your languages

Svalla supports multiple languages out of the box. You need at least one language configured before creating content.

Go to Settings → Languages and add the languages your site will support. Each language will have:

• Its own content translations
• Language-specific URL slugs
• Independent publication status

You can set a default language that will be used as the primary content language.

Define your content model

A post type defines the kind of content you want to manage — pages, blog articles, products, team members, or anything else.

To create a post type:

• Go to Post Types in the sidebar
• Click "New Post Type"
• Set a title, key, and URL slug per language
• Choose options: single page, hierarchical, or collection
• Assign one or more templates

Post types are the foundation of your content structure. Think of them as content categories that define what kind of pages your site will have.

Design your page layout

A template defines the layout of a page by combining multiple sections. Each section represents a distinct part of the page (hero, features, testimonials, etc.).

To create a template:

• Go to Templates in the sidebar
• Click "New Template"
• Add sections and arrange them in order
• Assign the template to a post type

Sections are reusable — you can use the same section across different templates. Each section has its own data structure defined in the Section Builder.

Add content and publish

With your post type and template ready, you can create your first page:

• Go to your post type (e.g., Pages)
• Click "New Post"
• Enter a title and URL slug
• Select the template you created
• Fill in the content for each section
• Click "Publish" to make it live

Your content is now available through the GraphQL API and ready to be consumed by your frontend application.

Fetch content via the API

Svalla delivers content through a GraphQL API. Your frontend application queries the API to retrieve pages, posts, media, and any other content.

Basic setup:

• Get your API endpoint from Settings → API
• Generate an authentication token
• Use any GraphQL client (Apollo, urql, or plain fetch) to query content
• Build your pages using the returned data

The API supports advanced features like filtering by categories, full-text search, pagination, and language-specific queries. See the Headless API section for full documentation.