Settings
Settings
The Settings page lets you update your personal profile, configure your organization, change your password, and manage your subscription — organized into four tabs.
Purpose
Settings consolidates all account-level configuration in one place. Changes to your profile affect how you appear in audit logs and notifications. Organization settings control your Shopify integration and displayed org name. Security settings let you rotate your password. The Billing tab provides a shortcut to Stripe plan management.
Profile Tab — Updating Your Profile
- 1.Go to Dashboard → Settings. The Profile tab opens by default.
- 2.Update First Name and Last Name as needed.
- 3.Update your Email address. Note: email is also your login credential.
- 4.Click "Save Changes". A success toast confirms the update.
Your Role badge (admin / editor / viewer) is displayed on the Profile tab but cannot be changed here. Roles are assigned by your organization admin.
Organization Tab — Org Settings
- 1.Click the Organization tab.
- 2.Update "Organization Name" — this appears in exported labels and your public passport data.
- 3.Set or update "Shopify Domain" if you use Shopify integration (see below).
- 4.Click "Save Organization".
Shopify Domain
Format: yourstore.myshopify.com
This is required to use Shopify Sync in Import. Find your domain in your Shopify admin under Settings → Domains. Use the internal*.myshopify.com domain, not your custom storefront domain.
Security Tab — Changing Your Password
- 1.Click the Security tab.
- 2.Enter your Current Password.
- 3.Enter a New Password (minimum 8 characters).
- 4.Re-enter the new password in Confirm New Password.
- 5.A green checkmark appears when both new password fields match.
- 6.Click "Change Password". A success toast confirms the change.
Password Rules
Minimum 8 characters
The new password and confirmation must match exactly
Current password must be correct — the API rejects the request otherwise
After a successful change, your existing session remains active
Billing Tab
The Billing tab shows your current plan and a plan comparison table. Click Manage Billing to open the Stripe Customer Portal where you can upgrade, downgrade, cancel, update payment methods, and download invoices.
Full Billing documentationUser Roles Reference
adminFull access. Can create, edit, and delete products, passports, suppliers, and labels. Can manage billing and organization settings. Can invite users.
editorCan create and edit products, passports, suppliers, and labels. Cannot manage billing, organization settings, or user invitations.
viewerRead-only access. Can view all passports, products, suppliers, labels, and analytics. Cannot create or modify any records.
Validation Rules & Edge Cases
Email already in use
If you change your email to one already registered to another account, the update will be rejected with a 409 error.
Shopify domain format
Must end in .myshopify.com. Custom domains (e.g., yourstore.com) are not accepted.
Password too short
The Change Password button is disabled until both new password fields match and are at least 8 characters.
Wrong current password
The API returns an error; a toast shows 'Failed to change password. Check your current password.'
What Success Looks Like
A green "Profile updated" toast appears after saving profile changes.
A green "Organization updated" toast appears after saving org changes.
The Security tab shows a green "Passwords match" indicator before submitting.
A green "Password changed successfully" toast confirms the password change.
Troubleshooting
Profile save shows no feedback and nothing updates
Fix: Check your network connection. Open the browser console for API errors. If a 401 appears, your session expired — log out and back in.
Shopify domain rejected with a validation error
Fix: Ensure you are entering the myshopify.com domain (e.g., yourstore.myshopify.com) and not your custom storefront domain.
'Change Password' button remains disabled
Fix: Ensure the New Password and Confirm New Password fields match exactly and are at least 8 characters long.
Password change fails with 'check your current password'
Fix: You have entered the wrong current password. If you have forgotten it, log out and use the password reset flow on the login page.
Settings page does not load — stays on the loading spinner
Fix: Your auth token may have expired. Refresh the page. If the spinner persists, log out and back in.