Developer projects, which include Matter integrations, are
managed on the [Google Home Developer Console](https://console.home.google.com). This page explains how to set up
a new developer project on the Developer Console.

## Name the project

When naming your project, it's good practice to compose a name that:

- Incorporates some basic information about the project.
- Won't be confused with that of another project.
- Can represent all the integrations within the project.

Meaningful names are important. A generic name such as `project-gamma-798`, is
effectively "camouflaged" and won't stand out in a list of other
generically-named projects.

Consider the following guidance when naming your project:

- Use your company name
- Use the type of project or action in the name
- Don't use "test" in the project name

For example, `acme-smarthome` and `acme-lighting` are clear and unique project
names.

## Create the project

A developer project represents one or more integrations.
By sharing a project with the members of their development team, the
owner can allow other users to manage all integrations in the project.

Google Smart Home Ecosystem integrations are managed using the
Developer Console.

We recommend creating only one project for all your Matter
integrations, both testing and production, particularly to avoid issues when
testing with test Vendor IDs and Product IDs for Matter.

> [!IMPORTANT]
> **Important:** While test Vendor IDs and Product IDs for Matter can be duplicated across Matter integrations, a single production Vendor ID and Product ID combination can only be used in **one
> Matter integration** , in **one project**.

### Method 1: Create a new project

Go to the Developer Console:

[Go to the Developer Console](https://console.home.google.com)

1. On the **Manage projects** page, click **Create a project**.
2. On the **Get started** page, click **Create project**.
3. Enter the name of your project, which should adhere to [the project naming
   guidelines](https://developers.home.google.com/matter/project/create#name_the_project).
4. Click **Create new project**.

You are redirected back to the **Home** page for the new project.

### Method 2: Import an existing project from the Actions on Google console

An existing Actions on Google project may be imported into the new
Developer Console, if you need to add Matter
support to an existing Cloud-to-cloud or Local Home SDK
integration.

The following restrictions apply to this method:

- **This import is one-way only. It cannot be reversed.**
- Only the project owner can import an existing Actions on Google project. The owner is whoever created the project, which is viewable using the [Members link](https://developers.home.google.com/matter/project/create.md.txt#share_a_developer_project).
- The Company Profile for an imported project can only be edited in the [Actions on Google
  Console](https://console.actions.google.com). Changes there will be reflected in the Google Home Developer Console.

After import, the original Actions on Google project can still be used
to manage existing integrations (such as Cloud-to-cloud,
Local Home, App Discovery).

To import an existing project from the Actions on Google Console, go to the
Developer Console:

[Go to the Developer Console](https://console.home.google.com)

1. Click **Create a Project**.
2. Enter an existing Actions project name or select a project from the drop-down list (for example, in the following screenshot, the project name is "My matter project").
3. Click **Import project**.

You are redirected back to the existing project details in
Developer Console.

![Google Home Developer Center Get
started](https://developers.home.google.com/static/project/images/GHDC_get_started-001.png "Google Home Developer Console Get started page")

## Set log levels

By default, only error logs are saved to Google Cloud for each
integration in your project.

To save all logs to Google Cloud for each integration, select **All
logs** in the **Log level control: Error logs** section.

![Google Home Developer Center project log levels](https://developers.home.google.com/static/project/images/GHDC_log-level.png "Google Home Developer Console project log levels")

This setting applies to *all* integrations in
your project. It can only be overridden for Cloud-to-cloud
integrations. Saving all logs to Google Cloud may incur additional
cost if your log storage space is exceeded.

To learn more about logs, see
[Cloud logging for Matter](https://developers.home.google.com/matter/analytics/logging.md.txt).

## Share a developer project

You may add or remove access to a project among the users on your
team using [predefined roles](https://cloud.google.com/iam/docs/roles-overview#predefined).

> [!NOTE]
> **Note:** To add users to a project, you must have the Owner role on the project.

1. On the **Home** page of the Developer Console click
   **Members** , which takes you to the **IAM \& Admin** \> **IAM** page
   on the Google Cloud Console.

   Or, click **Project details** , then click **Manage members in GCP** in the
   **Members** section at the bottom.
2. Make changes as necessary using the Google Cloud Console
   dashboard.

For instructions for how to modify access to a project, refer to the
[Access control for projects with IAM](https://cloud.google.com/resource-manager/docs/access-control-proj).

Once added to the list of users, a user can view the project and any
integrations in the Developer Console.

> [!NOTE]
> **Note:** The system does not proactively notify users added to a project.

According to your organizational setting, you might experience permission errors
when attempting to create developer projects. If so, reach out to your
Google Cloud administrator and request
[Project Creator permissions](https://cloud.google.com/resource-manager/docs/access-control-proj#resourcemanager.projectCreator) for your account.