> ## Documentation Index
> Fetch the complete documentation index at: https://docs.choicely.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Shop

> Enable in-app purchases, subscriptions, and paid votes in your iOS app

## Features

* **In-App Purchases** – Allow users to buy items, upgrades, or digital content inside your app.

* **Subscriptions** – Offer recurring subscription plans to give users ongoing access to premium features or content.

* **Paid Votes** – Monetize voting by enabling users to purchase voting credits, which can be used in competitions or polls.

<Warning>
  Shop features are available only to users with Premium account.
</Warning>

## Add ChoicelyShop to your project

<Note>
  If you haven't added the Choicely SDK to your project yet, please follow the steps in the [Quick start](/ios/quick-start) section.
</Note>

1. Select your target and go to "General" tab. Click the "+" button on "Frameworks, Libraries, and Embedded Content" section and add ChoicelyShop module.

2. That's it! Everything is ready for ChoicelyShop features setup.

## Setup In-App Purchases

### App Store Connect

1. In your app's App Store Connect page select "In-App Purchases" under "Monetization" side menu section. Click "+" button to create new In-App Purchase.

2. Select "Consumable" for type and add a reference name (can be anything). Choose product ID that will be added to Choicely Studio later.

   <Frame>
     <img src="https://mintcdn.com/choicely/5ATW2QVKA6uvu958/images/mobile-sdk/connect-purchase.png?fit=max&auto=format&n=5ATW2QVKA6uvu958&q=85&s=0cddb87c8147d1502ca82e5aeeebba95" alt="App Store Connect In-App Purchase" width="665" height="448" data-path="images/mobile-sdk/connect-purchase.png" />
   </Frame>

3. Click create and fill in the required fields (price, availability etc.)

### Choicely Studio

1. In Choicely Studio select your app, go to "Settings" tab on top and select "In-App Purchases".

2. Create as many packages as you need.

3. Map the product ID previously created in App Store Connect to the Store ID.

   <Frame>
     <img src="https://mintcdn.com/choicely/5ATW2QVKA6uvu958/images/mobile-sdk/studio-purchase.png?fit=max&auto=format&n=5ATW2QVKA6uvu958&q=85&s=b347b9a3cabdb88d0628be09d27641b2" alt="Choicely Studio In-App Purchase" width="961" height="1110" data-path="images/mobile-sdk/studio-purchase.png" />
   </Frame>

4. Click "Update" button in the top right corner.

5. That's it! You're now ready to start using in-app purchases feature in your apps.

## Setup Subscriptions

### App Store Connect

1. In your app's App Store Connect page under "Monetization" side menu section select "Subscriptions". Click "+" button to create new Subscription Group. Enter the reference name and click "Create".

   <Frame>
     <img src="https://mintcdn.com/choicely/5ATW2QVKA6uvu958/images/mobile-sdk/create-subscription-group.png?fit=max&auto=format&n=5ATW2QVKA6uvu958&q=85&s=abb195f0966336ff271acc3d3f744b34" alt="Create Subscription Group" width="573" height="289" data-path="images/mobile-sdk/create-subscription-group.png" />
   </Frame>

2. Click "+" button to create a new Subscription. Enter the reference name and product id for subscription and click "Create".

   <Frame>
     <img src="https://mintcdn.com/choicely/5ATW2QVKA6uvu958/images/mobile-sdk/create-subscription.png?fit=max&auto=format&n=5ATW2QVKA6uvu958&q=85&s=109fd8495e9323e3ef7c5865d067334f" alt="Create Subscription" width="574" height="280" data-path="images/mobile-sdk/create-subscription.png" />
   </Frame>

3. You will be redirected to subscription details page where you should set its duration, availability, prices and localization. Go back to subscription group details and set its localization. When everything is set up it will look like this:

   <Frame>
     <img src="https://mintcdn.com/choicely/5ATW2QVKA6uvu958/images/mobile-sdk/your-subscriptions-group.png?fit=max&auto=format&n=5ATW2QVKA6uvu958&q=85&s=1bc224a1f467799b8b832e3f5a098480" alt="Subscription Group" width="861" height="749" data-path="images/mobile-sdk/your-subscriptions-group.png" />
   </Frame>

### Choicely Studio

1. In your apps Choicely Studio select "Shop" section in the side menu. Select "Subscription" tab and click "Create Shop" button. Confirm that you want to create a new subscription shop.

   <Frame>
     <img src="https://mintcdn.com/choicely/5ATW2QVKA6uvu958/images/mobile-sdk/shops.png?fit=max&auto=format&n=5ATW2QVKA6uvu958&q=85&s=c3414ac83a4710350e2dd37680e0c4f5" alt="Shops" width="581" height="389" data-path="images/mobile-sdk/shops.png" />
   </Frame>

2. You will see a blank package and a button with "+ Package" title. Click on it and enter packages title and price.

   <Frame>
     <img src="https://mintcdn.com/choicely/5ATW2QVKA6uvu958/images/mobile-sdk/create-package.png?fit=max&auto=format&n=5ATW2QVKA6uvu958&q=85&s=259242285a337a4e81042b6095b5c01e" alt="Create Package" width="333" height="202" data-path="images/mobile-sdk/create-package.png" />
   </Frame>

3. Click "Add" button and you will see your newly created subscription package with all its options. Set its duration, StoreID (subscrioption product id from App Store Connect) and navigation.

   <Frame>
     <img src="https://mintcdn.com/choicely/5ATW2QVKA6uvu958/images/mobile-sdk/subscription-package-details.png?fit=max&auto=format&n=5ATW2QVKA6uvu958&q=85&s=31f58a4e052a1dc8c7fce73bc878c37b" alt="Subscription Package Details" width="972" height="623" data-path="images/mobile-sdk/subscription-package-details.png" />
   </Frame>

4. You're almost done! The last thing to do is to set the AppStore settings for your app. Go to "Settings" -> "General Settings" -> "App Store Settings".

   <Frame>
     <img src="https://mintcdn.com/choicely/5ATW2QVKA6uvu958/images/mobile-sdk/studio-general-settings.png?fit=max&auto=format&n=5ATW2QVKA6uvu958&q=85&s=6c8c3853f396471752cdec538e7ce6a7" alt="Studio General Settings" width="986" height="542" data-path="images/mobile-sdk/studio-general-settings.png" />
   </Frame>

5. In the popup fill Bundle ID, Team ID, App Store ID and Access Key fields.

   <Frame>
     <img src="https://mintcdn.com/choicely/5ATW2QVKA6uvu958/images/mobile-sdk/app-store-settings.png?fit=max&auto=format&n=5ATW2QVKA6uvu958&q=85&s=9f11d3d5be8bf2d02c18566e42f62147" alt="App Store Settings" width="372" height="428" data-path="images/mobile-sdk/app-store-settings.png" />
   </Frame>

   <Warning>
     Some key names can differ from App Store Connect. Take a look at the table of terms correspondence:
   </Warning>

   |                       |           |         |              |                            |
   | --------------------- | --------- | ------- | ------------ | -------------------------- |
   | **Choicely Studio**   | Bundle ID | Team ID | App Store ID | Access Key                 |
   | **App Store Connect** | Bundle ID | Team ID | Apple ID     | App-Specific Shared Secret |

   <Note>
     You can find Bundle ID and App Store ID in your app's App Store Connect -> "General" -> "App Information" -> "General Information" section.

     Access Key under App Store Connect -> "General" -> "App Information" -> "App-Specific Shared Secret" section.

     Team ID in [Apple developer](https://developer.apple.com/account) portal under "Membership details" section.
   </Note>

6. Close the popup and click "Update" button in the top right corner.

7. That's it! You're now ready to start using subscription features in your apps.
