Importing and linking existing datasources

Creating a linked project
Changing linked project settings

Instead of starting from scratch, if you already have an existing database or datasource, you can link to it and start building on top of it almost instantly.

When you link to an existing datasource, the content model is automatically generated by introspecting your existing database. In addition, it will also use your existing database as the primary datasource.

The content management system and APIs will read and write to your existing database.

Creating a linked project

To create a linked project, head over to the projects page and click on + Create New.



Enter the name of your project and other basic details around the type of project you're creating (need not be related to the datasource).

Once you're done entering the details, click on the Next button.

Import Types


  • LINK

    This uses your existing database as a primary datasource. The APIs and the CMS will connect to your existing datasource for all read and write operations.


    This uses a fresh Canonic provisioned database. The APIs and the CMS will connect to the new datasource and will only use your existing datasource to generate the content model. Your existing datasource is untouched.

After selecting the import type, click Next.

Datasource configuration

You will be presented with a screen to configure your datasource. Select the database type and the connection and authentication details.


Click on Create to begin the import process.


The import process takes about half a minute.

Once the import is complete, confirm that all the fields are correct and hit deploy to generate the APIs and the CMS.

Changing linked project settings

You can edit the datasource settings that were presented to you during import in the Project Settings.

Note: This is a dangerous action. Please proceed with caution.

Did you find what you were looking for?
What went wrong?
Need more help?We have a thriving Discordcommunity that can help you with all things Canonic. β†’