---
title: Import unassigned shareable codes
slug: 67rG-import-unassigned-shareable-codes
description: If you are a non-Shopify brand (or a Shopify brand using a manual discount rule), importing unassigned shareable codes is the primary way to automate issuing.
docTags: 
createdAt: 2025-01-22T20:43:24.527Z
---

If you are a non-Shopify brand (or a Shopify brand using a manual discount rule), importing unassigned shareable codes is the primary way to automate issuing discount codes to ambassadors. This guide will walk you through the steps to import unassigned codes into a discount rule.

***

## Step-by-step instructions



:::::WorkflowBlock
:::WorkflowBlockItem
### Generate codes in your e-commerce platform

In order to import unassigned discount codes into Roster, you will need to first generate a batch of discount codes in your e-commerce platform. As each platform is different, you may need to inquire with your specific platform on how to pre-generate a batch of codes.
:::

:::WorkflowBlockItem
### Prepare your CSV file

Once you have generated a batch of codes, you need to add them to a CSV file.

1. Ensure your CSV file contains one column labeled `Code`.
2. Each row should contain one and only one of the codes you generated.

Download this sample CSV for reference: 

::File{src="https://api.archbee.com/api/presign/1gdZ9Yjy-k8GW0Lioyrwz-bBkIZlrr4lgWRLlb9wmYt-20241223-210428.csv" label="codes.csv"}
:::

::::WorkflowBlockItem
### Open the shareable discount rule in Roster

1. Log in to your Roster account.
2. Navigate to the `Discount Rules` page and select the relevant *shareable* discount rule (e.g., linked to a specific ambassador program).

:::hint{type="info"}
If you haven't already imported unassigned codes into this discount rule, it will show 0 under the `Unassigned codes` header.
:::
::::

:::WorkflowBlockItem
### Start the import process

1. Click on `More Actions` > `Import`.
2. Select `Import unassigned codes` from the popup menu.
:::

:::WorkflowBlockItem
### Upload the CSV file

1. Click `Browse` and select your prepared CSV file.
2. Roster will display a preview of the first two codes and show the total number of codes to be imported.
3. Verify the preview and click `Import`.
4. Wait for the import to complete. For large imports (hundreds or thousands of codes), this may take a minute or two.
:::

:::WorkflowBlockItem
### Confirm imported codes

1. The system does not display individual unassigned codes to prevent unauthorized use.
2. Check the `Unassigned Codes` count at the top of the discount rule to ensure the codes were imported.
:::

:::WorkflowBlockItem
### Automate code assignment for ambassadors

1. Ambassadors in the linked program will automatically receive an unassigned code the first time they request their shareable code in the Ambassador Portal.
2. Roster will assign the next available unassigned code to the ambassador, making it their unique shareable code.

::Image[]{src="https://api.archbee.com/api/optimize/mmAK_JBzN5YWZNnNvmD7r/aRQyWdL_vCOJi1MHSXloA_cleanshot-2025-01-23-at-121055.gif" size="40" width="410" height="800" position="center" showCaption="false"}
:::

:::WorkflowBlockItem
### Set up low-code reminders (optional)

1. Click on `More Actions` > `Set reminder`.
2. Select one or more team members and a threshold (e.g., 5 unassigned codes).
3. Roster will send a notification when the unassigned code count drops below this threshold, ensuring you upload more codes in time.
:::
:::::

***

## Related articles

- [Import unassigned reward codes](docId\:kow80kdg8ep64tg_wzDoT) 
- [Import assigned reward codes](docId\:GQ8-fmgl4zJi3fKilnxMc) 
- [Import assigned reward codes](docId\:GQ8-fmgl4zJi3fKilnxMc) 

## Need help?

For questions about importing unassigned shareable codes or additional guidance, please contact us at [support@getroster.com](mailto\:support@getroster.com). For related topics, see the article on manually assigning shareable codes to ambassadors.