Manage theme access
The Theme Access app allows you to securely create and manage passwords that developers need to use to work on a theme using Shopify CLI 3.x (and the deprecated Theme Kit). This guide explains how to install the Theme Access app, and then share credentials with developers.
Requirements
Anchor link to section titled "Requirements"To set up the Theme Access app, you need to have access to the associated store through one of the following roles, which must have the corresponding permissions:
| Role | Permission category | Permission |
|---|---|---|
| Store owner | Not applicable | Not applicable |
| Staff | Administration permissions | Edit permissions (including Add and remove staff) |
| Online store permissions | Themes | |
| Collaborator | Online store permissions | Themes |
How the Theme Access app works
Anchor link to section titled "How the Theme Access app works"The Theme Access app is available as a free download from the Shopify App Store.
After you install the Theme Access app on your store, you can create passwords to share with developers that would like to access your themes. The app generates passwords that are scoped to grant developers with only write access to themes (write_themes).
After a developer receives a link to the password in their email, in order to connect to your store and begin making changes to themes, they can supply the password in different ways:
| Tool | Method |
|---|---|
| Shopify CLI |
|
| Theme Kit (deprecated) | Using a config file or environment variable. |
Install the Theme Access app
Anchor link to section titled "Install the Theme Access app"To get started, install the Theme Access app on your store.
- Go to the Theme Access app page on the Shopify App Store.
- On the Theme Access app page, click Add app.
- In your Shopify admin, to authorize the use of the app, click Install app.
After the app is installed, you can view and use it from the Apps page in your Shopify admin.
Create a password
Anchor link to section titled "Create a password"To grant a developer access to develop your theme using Shopify CLI, you can create a password. The password is sent to the developer's email, which contains a link to the password. The link expires after 7 days or after the password has been viewed by the developer. The developer can view the password only once.
- From the Theme Access app, click Create theme password.
- Enter the contact details for the developer that is working on your theme and click Create password.
Resend a password
Anchor link to section titled "Resend a password"If the developer didn't receive the password or if their invitation expired, then you can resend the email containing the link to the password.
- From the Passwords page in the Theme Access app, click Details next to developer that needs the password re-sent.
- Click Resend email.
The password is sent to the developer's email address. The email that contains the password expires after 7 days or after the password has been viewed by the developer.
Delete a password
Anchor link to section titled "Delete a password"You can delete a developer's password if they no longer need access to your store. Deleting a password revokes access to the store's themes. If you wanted to grant access to the developer again, then you would need to create a new password.
- From the Passwords page in the Theme Access app, click Delete next to the developer whose access you want to remove.
- Click Delete to confirm removing the developer's password.