# Link

Link this project to a project on velastack.dev.

### Syntax

```
$ vela link
```

You'll be shown the teams and projects on your account and can pick one, or create a new project. Running it again on an already-linked project reports what it is linked to and does nothing else.

Requires an account — run [`vela login`](/account/login) first. A project scaffolded with [`vela create`](/create) while logged in is linked already; this command is for projects that exist without one.

### What linking is for

- Deploy history for the project on velastack.dev
- A free `velastack.app` hostname on [deploy](/deploy)
- The project's hosted CMS, which CMS-ready templates read from
- The AI options on the [generators](/generate), which are billed to the project

Linking is optional. An unlinked project builds, tests and deploys exactly the same way — see [Account](/account).