Organizations, Teams, and Projects

Organizations act as a parent to Teams and Projects. When creating a Project, you can assign it to an Organization of your choice. Teams within an Organization help you manage access permissions for a Project. Users can belong to multiple Organizations, but Projects and Teams can belong to only one Organization.

Manage Organizations

Create an Organization

By default, signing up for a Merchant Center account will also create an Organization for you.

One Organization should be enough for most implementations. However, some implementations choose to have separate staging and production Organizations.

To create an Organization, do the following:

1. Click the profile icon, and then select Manage organizations & teams.
2. Click Add organization, enter the name of the Organization, and then click Create.

Rename an Organization

To rename an Organization, do the following:

1. Click the profile icon, and then select Manage organizations & teams.
2. Select the respective Organization, and then click the Edit organization name icon.
3. Edit the name of the Organization, and then click Update.

Delete an Organization

To delete an Organization, do the following:

1. Click the profile icon, and then select Manage organizations & teams.
2. Select the respective Organization, and then click the Delete organization icon.

Manage Teams

Teams help in grouping members of your Organization into logical units that you can assign permissions to. Teams cannot exist outside of an Organization. Creating an Organization automatically creates a default Team of Administrators. We recommend that you invite at least one other user to the Team. You can manage associated Teams on the respective Organization's page.

Create a Team

1. Click the profile icon, and then select Manage organizations & teams.
2. Select the Organization, and then click Add team.
3. Enter the name of the Team, and then click Create.

Invite users to a Team

Users can belong to multiple Teams. Adding a user to a Team grants them access to the Organization's Projects that the Team can access.

To invite users to a Team, do the following:

1. Click the profile icon, and then select Manage organizations & teams.

2. Select the Organization and Team.

3. On the Teams page, click Invite members.
4. In the Invite someone to the team dialog, do any one of the following:
   • Enter the first name, last name, or email address to search for and invite an existing member of the same Organization.
   • Enter the email address to invite a new user to the Organization.
5. Click Add member.

A sign-up link is sent to the invited users. When the users sign up, they are automatically added to your Organization.

Remove users from a Team

1. Click the profile icon, and then select Manage Organizations & Teams.
2. Select the Organization and Team.
3. On the Teams page, click the delete icon next to the user.
4. Click Remove member in the dialog.
   To remove a user from the Administrators Team, enter the Team name as "Administrators" for confirmation and then click Remove member.

Delete a Team

1. Click the profile icon, and then select Manage organizations & teams.
2. Select the respective Team, click the Delete team icon, and then confirm the action.

Manage Projects

Projects are distinct sets of Product data and Store configuration settings that belong to a single Organization. A single Project can provide the data for multiple selling Channels. Users must belong to a Team with appropriate permissions to access a Project.

Create a Project

1. Click the profile icon, and then select Manage projects.
2. Click Create new project.

3. Depending on your requirement, select whether to start your project either with your own data or with pre-filled sample data.

4. Enter the details for your Organization and Project, and then click Complete.
   • Organization name: Organization to which the Project belongs.
   • Project name: display name of the Project.
   • Project key: key of the Project.
     By default, Merchant Center suggests a Project key, but you can replace it as needed. The key must be unique and contain between two and 36 characters. It can contain only alphanumeric characters (a-Z, 0-9), underscores (_), and hyphens (-). The key must not contain any of these reserved words: local, admin, or config.
5. Click Complete.

Switch between Projects and locales

• Use the Projects menu to switch between the Projects to which you have access.

  

• Use the Locales menu to switch between different data locales. The Merchant Center uses the selected locale to display Project-specific data such as names, descriptions, and other localized attributes.

  
  To view or modify locales, go to Settings > Project settings. Click the International tab, and then scroll to the Languages section.
  The locale setting does not change the display language of the Merchant Center interface (for example, menu items and button text). To view or modify the interface language, click your user profile and go to My Profile > Personal Settings > Language and region.

Delete a Project

To delete a Project, do the following:

1. Click the profile icon, and then select Manage projects.
2. Click the Delete project icon in the Project row, enter the respective Project key, and then click Delete project.

Use Advanced Project management actions

• Activate a trial Project: If a Project is not activated at the end of the 60-day trial, it is marked with a Trial Ended flag. The Project data would still be available in the Merchant Center, but you can neither obtain API tokens for the Project nor make API calls.
  To activate a Project, contact the Composable Commerce support team.
• Mark a Project as in production: The In production flag lets our Support team know that a Project is live and is accepting traffic from customers. By default, this flag is deactivated for all Projects that are created.
  To mark a Project as in production, contact the Composable Commerce support team.
  
• Transfer a Project to another Organization: To transfer a Project to another Organization, contact the Composable Commerce support team.

Configure single sign-on (SSO) for an Organization

After you have registered the Merchant Center with your Identity Provider, do the following to configure SSO for you Organization:

1. Click the profile icon, and then select Manage organizations & teams.

2. Select the Organization for which you want to configure SSO.

3. In the Settings tab, click the Edit SSO configuration icon, and then do the following:
   • For OpenID Provider Configuration URL, enter the OpenID Connect Discovery endpoint {url}/.well-known/openid-configuration generated by the Identity Provider.
   • For Client ID, enter the client ID generated by the Identity Provider.
   • For Client secret, enter the client secret generated by the Identity Provider.
   • For Team, select the Team to which new users would be added after they log in with SSO.
     We recommend that you assign users to a Team with limited permissions. You can then reassign users to appropriate Teams after they log in to the Merchant Center.
   • Optional: If the Identity Provider does not support the end_session_endpoint for RP-Initiated Logout, then enter an explicit logout URL for Logout URL. Users logging out of the Merchant Center are then redirected to this URL.
   • Optional: To pass query parameters along with the logout URL, click Add new query parameter and then enter the values for Key and Value.
     For example, if supported by the Identity Provider, you can include a redirectTo query parameter with a URL back to the Merchant Center. In this scenario, make sure that the redirectTo parameter points to the correct Region.
   • Optional: To shorten the default SSO session validity of 30 days, select Use a custom expiration time and then choose either the 1-24 hours or 1-29 days option. The updated session duration applies only to users of the Organization for which you want to update these settings.
     The timeout countdown starts from the time you log in to the Merchant Center. For example, if you configure a one hour-timeout, then your session will expire one hour after login, regardless of your activity within the Merchant Center.

4. Click the Single Sign-On (SSO) toggle.

FAQs

• first name: idToken.given_name, idToken.name, or idToken.sub
• last name: idToken.family_name, idToken.name, or idToken.sub

No, each user can log in to only one Organization.

No, it is not possible.