Import & Export Profiles
On this page
Before you start1. Select a profile groupHow do I export my profiles?How do I import my profiles?Random values in profile CSV filesIf something does not import correctlyImport and export profiles in Stellar AIO 4.0, prepare a CSV template, and use random tokens.
Use the Profiles tab to import multiple checkout profiles from a file or export profiles you have already saved. A CSV is a spreadsheet-style file that stores one profile per row.
This guide covers profile files. To transfer your full Stellar setup, including tasks, proxies, accounts, and settings, use Settings → Data Management and follow the computer-transfer guide instead.
Before you start
- Use the latest Stellar AIO 4.0 CSV template so your column names match the current importer.
- Keep a backup of any existing profile file before editing it.
- Profile files can contain personal and payment information. Store them privately and do not post them in public Discord channels.
1. Select a profile group
Open Profiles in the sidebar, then select the group you want to work with.
For a new import, creating a separate group makes the imported profiles easier to check. Select the + beside PROFILE GROUPS, enter a clear name, and select Add. Select that group before importing.
How do I export my profiles?
- Select the profile group you want to export. Clear any individual profile selections so you are working with the group.
- Click Export to CSV.
- Choose a filename and save location in the save dialog, then select Save.
- Check the saved file to confirm it contains the profiles you intended to export.
The arrow beside Export to CSV also offers Export to JSON. CSV is the option to use for the spreadsheet walkthrough below. Keep the file format appropriate for the app you plan to import into.
If the group is empty, there are no profiles to export. Select a group containing saved profiles.
How do I import my profiles?
1. Download the CSV template
- Select your destination profile group.
- Click the small arrow beside Import.
- Select Download CSV Template.
- Choose where to save the template and select Save.
2. Fill in the template
- Open the CSV in Excel or Google Sheets. If your spreadsheet app changes the file's layout when it saves, such as adding an empty row or column, edit the file in a CSV editor such as Modern CSV instead.
- Keep the header row and column names unchanged. Enter one profile per row beneath the headers.
- Fill in the profile’s contact, shipping, billing, and payment details in the matching columns.
- Review the values before saving. You can use the random tokens explained below in supported CSV cells.
- Save or download the completed file as CSV. An Excel workbook (.xlsx) or a Google Sheets link is not a CSV file.
Preserve values exactly: Treat card numbers, phone numbers, postal codes, and other identifiers as text in your spreadsheet. This helps prevent dropped leading zeros, rounded long numbers, or scientific notation. Check these fields before importing; changing the format after a number has already been altered will not restore the original digits.
If you create more than one spreadsheet tab, make sure you save the tab containing the completed profile rows.
Check the CSV separator before importing. Settings → General → CSV Separator Character applies to both imports and exports. A separator is the character between columns, usually a comma (,) or semicolon (;). Match Stellar’s setting to the separator in your file. If your spreadsheet saves a comma-separated CSV, select a comma in Stellar before importing it. Changing the setting does not convert a file you already saved.
If the CSV opens as one long column, reopen it using your spreadsheet’s import options and choose the separator used by the file. Confirm that headers and profile values appear in separate columns, then preserve the column names and save as CSV. Do not replace every comma or semicolon in the file by hand; those characters can also be part of a field’s contents.
3. Import the completed file
- Return to Stellar and select the destination profile group.
- Click Import itself, rather than the arrow used to download the template.
- Choose your completed CSV in the file picker and confirm the import.
- Review the profiles that appear in the group before using them in tasks.
Imports add profiles; they do not replace existing profiles. Do not use re-importing as a way to update profiles already saved in Stellar. Check the group before importing the same file again so you do not add profiles you do not need.
Stellar also supports profile exports from AYCD and Essentials. Use Import to select the supported export file. If you are creating or editing a CSV yourself, start with Stellar’s downloadable template.
4. Check the imported profiles
Check the profile names and number of profiles, then open a few profiles and review their contact information, shipping and billing addresses, and payment details. If you used tokens, check the generated values too. Follow your retailer’s guide for any checkout-specific requirements.
Random values in profile CSV files
Stellar supports tokens that generate random characters in profile CSV cells. A token is a short placeholder written inside braces, such as {number:4}. Use the exact syntax below, including the braces and colon.
Random text does not make valid checkout details. These examples demonstrate the token format; they do not create an email inbox, a working phone number, a deliverable address, or a valid payment card. Use contact details you control and valid shipping and payment information where required. In particular, a random 16-digit value is not a valid card number.
Start with a profile name: put Profile {number:3} in PROFILE_NAME to create a label such as Profile 582. Keep the actual contact, address and payment fields valid. Randomizing an email address is different from setting up a catchall domain that forwards mail to an inbox you control.
Supported tokens
{char:N}generates N random letters, using uppercase and lowercase letters (A–Z, a–z).{number:N}generates N random digits (0–9).{alphanum:N}generates N random letters and digits.
Replace N with the length you want. It must be a whole number greater than 0. For example, {number:4} generates four digits. You can put several tokens in one cell and mix them with normal text.
Examples
These are possible results; the random characters will vary.
Main {alphanum:5}→Main a8Kd2john{number:4}@gmail.com→john5821@gmail.com{char:8}@outlook.com→kQzLmWpa@outlook.com555{number:7}→5558193046{number:16}→4829301746582013
You can also combine tokens in a single cell. For example, Profile {char:3}-{number:2} could become Profile Abx-47.
Using tokens in the CSV template
- Download Stellar’s profile CSV template and open it in Excel or Google Sheets.
- Enter tokens directly in the cells where you want random values. Keep the template’s column headers unchanged.
- Complete the remaining profile fields and save the file as CSV.
- Import the CSV into Stellar, then review the resulting profiles before using them in tasks.
Syntax illustration only: the sample cells below show how tokens fit into a row. Do not import these made-up contact or address details for checkout.
PROFILE_NAME:Profile {number:3}EMAIL:user{alphanum:6}@gmail.comPHONE:555{number:7}SHIPPING_FIRST_NAME:JohnSHIPPING_LAST_NAME:SmithSHIPPING_ADDRESS:{number:3} Main St
This is only part of a profile row. Complete the rest of the downloaded template with the information required for your profiles.
If something does not import correctly
- Make sure you selected the intended destination group.
- For a CSV you prepared yourself, compare its headers with a freshly downloaded Stellar template.
- Confirm the file is saved as CSV and that the correct spreadsheet tab was exported.
- Check for values altered by your spreadsheet app, particularly leading zeros and long numbers.
- Profiles skipped or names reported missing: your spreadsheet app may have changed the layout when it re-saved the file, for example by adding an unintended blank row above the header row or a blank column before the first header. Open the file in a CSV editor such as Modern CSV (on a Mac, right-click the file and choose Open With → Modern CSV). Remove only a row or column that is completely blank and sits before the template headers. Do not delete the header row, profile rows, or any column that contains data. If the layout is still wrong, copy your profile data into a freshly downloaded Stellar template. Also check that every profile row really has a name filled in.
- An error says phone numbers need to be added, but the phone column is filled in: this can happen when your spreadsheet app removes the leading 0 from phone numbers, which is common with UK numbers. Set the phone cells to text format, then re-enter the numbers in the expected format, for example 07XXXXXXXXX for a UK mobile number. Also check for phone cells that are actually empty or hold an invalid number. Make sure the file name ends in .csv, save it as CSV, and import again.
- Read any error message before retrying, and check whether profiles were added before importing again.
If you still need help, open a Support Ticket in #open-ticket. Include the exact error and the file format you used. Hide personal and payment details in screenshots.