<!--
{
  "documentType" : "article",
  "framework" : "watchOS Apps",
  "identifier" : "/documentation/watchOS-Apps/setting-up-a-watchos-project",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Setting up a watchOS project"
}
-->

# Setting up a watchOS project

Create a new watchOS project or add a watch target to an existing iOS project.

## Overview

Before you start a new watchOS project, you need to decide how you’re going to
distribute that project: as a watch-only app or as a watchOS app with an iOS
app. If your app is only available on Apple Watch, create a new watch-only
project. If you want both a watchOS and an iOS app that deliver related
experiences, either create a new watchOS app with a companion iOS app or add
a watchOS target to an existing iOS project.

### Create a new watchOS project

To create a new watchOS project:

1. In Xcode, choose File > New > Project.
2. Select the watchOS tab.
3. Select the App icon and click Next.
4. In the project options sheet, enter a name for the project. To create
   a watch-only app, select “Watch-only App.” To create both a watchOS app and
   an iOS app, select “Watch App with New Companion iOS App.” Then click Next.
5. Select a location for the project and click Create.

![A screenshot of Xcode’s project option sheet. The project name is set to MyWatchApp, and the Watch-only App setting is selected.](images/com.apple.watchOS-Apps/setting-up-a-watchos-project-project-settings@2x.png)

### Add a watchOS target to an existing iOS app

To add a watchOS target to an existing iOS project:

1. Select the project in the Project navigator.
2. Click the “Add a target” button in the Project editor.
3. Select the watchOS tab.
4. Select the App icon and click Next.
5. In the project option sheet, enter a name for the watchOS app, and select
   “Watch app for Existing iOS App.” Make sure to select the correct iOS app in
   the pull-down menu, and click Finish.

![A screenshot of Xcode’s project option sheet. The project name is set to MyWatchApp. The Watch app for Existing iOS App setting is selected, and MyApp is selected in the pull-down menu.](images/com.apple.watchOS-Apps/setting-up-a-watchos-project-adding-watch-target@2x.png)

## Topics

### Information property list keys

The keys that Xcode automatically sets in the information property list file
when you create a watchOS target.

  <doc://com.apple.documentation/documentation/BundleResources/Information-Property-List/WKWatchKitApp>

  <doc://com.apple.documentation/documentation/BundleResources/Information-Property-List/WKAppBundleIdentifier>

  <doc://com.apple.documentation/documentation/BundleResources/Information-Property-List/WKCompanionAppBundleIdentifier>

  <doc://com.apple.documentation/documentation/BundleResources/Information-Property-List/WKExtensionDelegateClassName>

  <doc://com.apple.documentation/documentation/BundleResources/Information-Property-List/WKRunsIndependentlyOfCompanionApp>

  <doc://com.apple.documentation/documentation/BundleResources/Information-Property-List/WKWatchOnly>



---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)