Docs

v.Latest
Introduction
Core Concepts
Querying Content
Editing
Customizing Tina
Going To Production
Media
Drafts
Guides
Further Reference
Upgrading from Alpha to Beta

Tina is currently in full release. While the content of this page may still be useful, we recommend using later versions of Tina – latest changes.

Beta Changes

Aside from some user interface improvements in the TinaCloud Dashboard, we've also been making a bunch of changes under the hood. One of the biggest of these changes is how we handle user accounts.

Previously when you created a TinaCloud account you were creating an organization that you accessed at https://OrgName.tina.io. We thought that giving each organization its own unique subdomain and pool of users would be neat, but after spending some time in that paradigm it turned out to be a lot of added complexity that didn't add much value.

With the release of the beta we're moving user accounts to the forefront. Whenever you create a TinaCloud account you'll always access it at https://app.tina.io. This means that even if you are part of multiple organizations, you'll only have a single Tina account.

Tools for creating/managing organizations within TinaCloud accounts are coming. For now we create a default organization, which you'll still be able to invite users to.

Migration Path

Since we're changing how user accounts work within TinaCloud, existing alpha users must recreate their TinaCloud account and update their TinaCloud Site. The good news is that since we don't control your content, there really isn't anything else to do.

Recreate your TinaCloud Account

Update your TinaCloud site

  1. Remove the tina-graphql-gateway and tina-graphql-gateway-cli dependencies.
yarn remove tina-graphql-gateway-cli tina-graphql-gateway
  1. Add the new Tina dependencies.
yarn add tinacms @tinacms/auth
yarn add -D @tinacms/cli
  1. Change any existing import from tina-graphql-gateway to tinacms.
  2. Update package.json. Replace yarn tina-gql calls with yarn tinacms.
  3. Update your site's environment variables.
  • Delete NEXT_PUBLIC_ORGANIZATION_NAME
  • Change NEXT_PUBLIC_TINA_CLIENT_ID to the Client ID found in your new TinaCloud Account.

That's it! With any luck you should be able to keep working on your Tina enabled site the same as before. We're not expecting to have to repeat this process when we make it to our first full release.

If you come across any problems or have any questions feel free to head over to our Discord! We'd love to hear from you.

Last Edited: September 17, 2024