Domains

plentymarkets includes an assistant that helps you manage your domains. You can use the assistant for example to create new domains or sub-domains and to migrate existing domains.

Service Centre was removed

Perhaps you can remember previously managing your domains in the menu plentymarkets Logo (Start) » Service centre. The Service Centre was phased out. Domains are now managed with the help of an assistant.

Availability after initial setup or changes

It can take up to 24 hours until all of the settings are available on all systems. This is because the servers need to be restarted periodically and the data is not distributed in the cloud immediately.

Table 1 includes explanations of the various domain types.

Table 1. Examples of domains
Type	Addition	Example name	TLD	Explanation
Domain	—	yourstore	.com	The word "domain" refers to an Internet address in the form of a name and an extension, i.e. the top level domain. The name can be chosen freely. A domain is unique, i.e. the exact same domain may never be used twice. Therefore, when registering a desired domain, e.g. with a hosting service provider, it is necessary to check whether the domain has already been used.
Subdomain	info.	yourstore	.com	You can create as many subdomains as you want for a domain. Subdomains do not need to be registered. Subdomains use variations of the domain name. They are either placed in front of or behind the domain name and they are separated from it with a period.
Additional domains	—	your-store your_store	.com	Additional domains are e.g. created with alternative names of the main domain. Additional domains redirect to the main domain. This ensures that the domain is also found if it is spelled differently. For example, the additional domain your-store.com would redirect customers to the main domain yourstore.com, even if they spelled it with a hyphen. The names and top level domains can be chosen freely for additional domains. Every additional domain receives the main domain’s IP address.

1. Accessing the domain assistant

Go to Setup » Assistants » Basic setup.
Click on the domain assistant.
→ If you’ve already configured domains, then you’ll see them listed here.
Click on an existing domain to open its settings. Or click on New configuration ().
The domain settings will vary depending on which type of domain you work with. In other words, you might not see all of the settings described on this page while you configure the domain in your plentymarkets system.

2. Choosing the domain type

Open the domain assistant and navigate to the step Domain type.
Choose the desired domain type. The steps and settings of the assistant will change depending on which domain type you choose. Expand the info box below () if you need additional information about one of the options.
Ready to continue? Click on Next

Additional information about the individual options

I want to…	Additional information
Order a new domain, hosted by plentysystems	You will receive an email when registering a .com domain. This email will ask you to confirm the WHOIS data that was entered. This email is sent to the email address that was entered under ADMIN-C in the handle data (WHOIS). If you do not receive an email, check that the email address is available and working.
Add a new domain, hosted externally	Use this option to link an existing, external domain with the plentymarkets system. The domain’s IP address will be displayed in the overview of domains. Then save the DNS data in your hosting service provider’s DNS zone area. If there is an IPv6 A Record in your externally managed domain, then remove this IPv6 A-Record.
Add a new subdomain to an existing domain	You can create as many subdomains as you want for a domain. You do not need to register these subdomains. For example, if you have the domain yourstore.com, then you could create the subdomain info.yourstore.com to provide special information about your online store with this domain. Use the drop-down list to select which main domain you want to link with the subdomain. Select the corresponding plentymarkets system as well.
Transfer an existing domain to plentysystems	The processing times may vary depending on the Top Level Domain: For .de domains: up to 24 hours For .com and .net domains: 3 to 7 days For .eu domains: up to 5 days You will receive an email if you relocate a .com or .net domain. The email will ask you to confirm the relocation. This email is sent to the email address that was entered under ADMIN-C in the handle data (WHOIS). If you do not receive an email, check that the email address is available and working. If the email address no longer exists, then ask your current domain provider to change the email address.

I want to…

Additional information

Order a new domain, hosted by plentysystems

You will receive an email when registering a .com domain. This email will ask you to confirm the WHOIS data that was entered. This email is sent to the email address that was entered under ADMIN-C in the handle data (WHOIS). If you do not receive an email, check that the email address is available and working.

Add a new domain, hosted externally

Use this option to link an existing, external domain with the plentymarkets system. The domain’s IP address will be displayed in the overview of domains. Then save the DNS data in your hosting service provider’s DNS zone area. If there is an IPv6 A Record in your externally managed domain, then remove this IPv6 A-Record.

Add a new subdomain to an existing domain

You can create as many subdomains as you want for a domain. You do not need to register these subdomains. For example, if you have the domain yourstore.com, then you could create the subdomain info.yourstore.com to provide special information about your online store with this domain. Use the drop-down list to select which main domain you want to link with the subdomain. Select the corresponding plentymarkets system as well.

Transfer an existing domain to plentysystems

The processing times may vary depending on the Top Level Domain:

For .de domains: up to 24 hours
For .com and .net domains: 3 to 7 days
For .eu domains: up to 5 days
You will receive an email if you relocate a .com or .net domain. The email will ask you to confirm the relocation. This email is sent to the email address that was entered under ADMIN-C in the handle data (WHOIS). If you do not receive an email, check that the email address is available and working. If the email address no longer exists, then ask your current domain provider to change the email address.

3. Naming the domain

Open the domain assistant and navigate to the step Name the domain.
Enter the desired domain name.
Select the appropriate domain options. Expand the info box below () if you need additional information about one of the options.
Ready to continue? Click on Next

Additional information about the individual options

Which settings are displayed here depends on which type of domain you selected in the previous step.

Setting	Explanation
Domain	Enter the desired domain name.
Top Level Domain	Select the top level domain (TLD) from the drop-down list, e.g. co.uk or com. You will see information about how much this domain will cost per month.
Confirm purchase	Toggle the button () to purchase the domain for the price shown.
Main domain	If you are creating a new subdomain for an existing main domain, then select the main domain from this list here.
Authcode	Enter the authcode from your previous provider.

Setting

Explanation

Domain

Enter the desired domain name.

Top Level Domain

Select the top level domain (TLD) from the drop-down list, e.g. co.uk or com. You will see information about how much this domain will cost per month.

Confirm purchase

Toggle the button () to purchase the domain for the price shown.

Main domain

If you are creating a new subdomain for an existing main domain, then select the main domain from this list here.

Authcode

Enter the authcode from your previous provider.

4. Choosing the client

Here you can link the domain to a plentymarkets system or change a system link. If you set up multiple domains, you can select which one should be used as the main domain for each plentymarkets client. The URL will then be displayed in the browser’s address line. This is also the case for the other domains. It can take up to 24 hours until all of the settings are available on all systems.

Switching the main domain

If you switch the main domain, then change the URL accordingly on all platforms and in the interface settings in your plentymarkets system, e.g. in the settings for payment providers.
In addition, go to Setup » Orders » Payment » EBICS and save the data there once again, in order to update the basic settings.

Linking an external system

You cannot link a plentymarkets system with an external server if the domain is your main domain. In this case, select a different main domain before proceeding.

Linking a plentymarkets system:

Open the domain assistant and navigate to the step Choose the client.
Use the drop-down list to select which plentymarkets system you want to link the domain to. If you use your own server, select the setting External server.
Optional: Enter the IP address (A-Record) of the external server.
Optional: Toggle the button () if you want this to be the client’s primary domain.

5. Saving the domain handle

Open the domain assistant and navigate to the step Domain-Handle.
Note: This step only appears if you selected Order a new domain, hosted by plentysystems in the step Domain type.
Enter the contact details of the domain owner.
Ready to continue? Click on Next

Telephone and fax number must be formatted correctly

Make sure you correctly format the telephone and fax number. Otherwise it will not be possible to complete the domain assistant and you will receive an error message.

Use the following format for the telephone and fax number:
+(CountryCode)(AreaCode)(TelephoneNumber)
Example: +4956198681100

If you don’t have a fax number, then enter the telephone number instead.

6. Current DNS settings

Your domain’s DNS settings are displayed here. DNS is short for Domain Name System. DNS allows people to access your website by entering its domain name instead of by entering its numerical IP address.

Practical example: Checking and modifying the DNS settings

You can find further information about DNS settings in this practical example. The page guides you step by step through the process of finding and modifying your current DNS entries.

Saving DNS settings with external domain providers

If your domain is hosted by an external provider, you need to save the DNS settings of your plentymarkets system with your external domain provider.

Here you can access the DNS settings and then save them with your external provider.

Accessing the DNS settings:

Open the domain assistant and navigate to the step Current DNS Settings.
Note: This step only appears if you selected Add a new domain, hosted externally in the step Domain type.
Take a look at the DNS settings. These settings are explained in the table.
Log into the service area of your domain provider.
Copy the DNS settings shown in plentymarkets into the relevant fields of the domain provider.
→ Check the documentation of the domain provider on how to do this.

Note: It can take up to 72 hours to process these changes. plentymarkets cannot influence this duration.

Entry	Explanation
Source	DNS source
Type	Type of DNS entry A = Assigns an IPv4 address CNAME = Assigns a different host
Target	The target of the entry. IP address = The IP address of the plentymarkets system. CNAME = The address of the AWS load balancer endpoint that provides elastic load balancing, i.e. autoscaling.

Entry

Explanation

Source

DNS source

Type

Type of DNS entry
A = Assigns an IPv4 address
CNAME = Assigns a different host

Target

The target of the entry.
IP address = The IP address of the plentymarkets system.
CNAME = The address of the AWS load balancer endpoint that provides elastic load balancing, i.e. autoscaling.

External domain: Updating DNS settings for autoscaling

If your domain is hosted by an external provider, you need to update the DNS settings of your plentymarkets system with your external domain provider to benefit from autoscaling. Proceed as described below to edit the DNS settings of the external domain.

Modifying the DNS settings:

Open the domain assistant and navigate to the step Current DNS Settings.
Note: This step only appears if you selected Add a new domain, hosted externally in the step Domain type.
Take a look at the DNS settings. These settings are explained in the table.
Check if there is a CNAME entry with the alias xxxx.eu-central-1.elb.amazonaws.com.
→ If this CNAME entry exists, the system is ready for AutoScaling. Continue with the next step.
Log into the service area of your domain provider.
Copy the DNS settings shown in plentymarkets into the relevant fields of the domain provider.
→ Check the documentation of the domain provider on how to do this.

Note: It can take up to 72 hours to process these changes. plentymarkets cannot influence this duration.

Entry	Explanation
Source	DNS source
Type	Type of DNS entry A = Assigns an IPv4 address CNAME = Assigns a different host
Target	The target of the entry. IP address = The IP address of the plentymarkets system. CNAME = The address of the AWS load balancer endpoint that provides elastic load balancing, i.e. autoscaling.

Entry

Explanation

Source

DNS source

Type

Type of DNS entry
A = Assigns an IPv4 address
CNAME = Assigns a different host

Target

The target of the entry.
IP address = The IP address of the plentymarkets system.
CNAME = The address of the AWS load balancer endpoint that provides elastic load balancing, i.e. autoscaling.

7. Choosing additional settings

Open the domain assistant and navigate to the step Choose additional settings.
Note: Which additional settings are displayed depends on how you configured the previous settings in the assistant.
Activate the additional settings as needed ().
→ An additional configuration step appears each time.
Expand the info boxes below () if you need additional information about one of the options.
Ready to continue? Click on Next

Settings for an external mail server

Here you’ll save information about the mail server that’s used to send and receive emails. No additional settings are required if you use the mailbox.org mail server. If you use your own server, then save the values for the IP address as well as MX10 through MX40 if available.

Setting	Explanation
spf	Enter the SPF record for your email provider.
ip	Enter the incoming mail server’s IP address. Access is provided with the address mail.[yourdomain].com. *Note:* Replace [yourdomain].com with your own domain.
mx10; mx20; mx30; mx40	Enter the mail server for receiving emails. The server MX10 takes priority. In other words, emails are first sent to mail server MX10. If this mail server is not available, the emails will be sent to the mail server MX20. The lower the MX number, the higher the server’s priority. *Tip:* You should save at least two mail servers to ensure that the availability is never compromised. For example, if a server is down or needs to be maintained, emails can still be received with the other server.

Setting

Explanation

spf

Enter the SPF record for your email provider.

Enter the incoming mail server’s IP address. Access is provided with the address mail.[yourdomain].com.
Note: Replace [yourdomain].com with your own domain.

mx10;
mx20;
mx30;
mx40

Enter the mail server for receiving emails. The server MX10 takes priority. In other words, emails are first sent to mail server MX10. If this mail server is not available, the emails will be sent to the mail server MX20. The lower the MX number, the higher the server’s priority.
Tip: You should save at least two mail servers to ensure that the availability is never compromised. For example, if a server is down or needs to be maintained, emails can still be received with the other server.

Generate an AuthCode

You need to have an authentication code for your domain if you switch to a different provider. This auth code proves that you own the domain.

Click on Generate. The code is generated and displayed in the field Domain Authcode.
Note: A domain auth code is valid for 30 days. If you do not use the code during this time, you will have to generate a new code when needed.

Further info

If you want to switch to a different webhosting provider, then you will need to carry out a domain name transfer (also known as a KK or auth info procedure in Germany). You need to fill out a standardized form of authorization in order for the domain to be transferred. The German form is called a connectivity coordination application, abbreviated as a KK-Antrag. The connectivity coordination application regulates the switch from one provider to another. The auth info procedure is becoming more and more popular.

Please note the following points when switching to a different web hosting provider:

Generate an auth code.
Do not delete your previous domain name with your current provider.
Tell your current provider about your plans to transfer the domain and let them know that they will soon receive an authorization form.
Contact the new provider in regards to the transfer. Your new provider will ask you to sign a form and confirm that you want to transfer the domain.

It is usually possible to transfer the domain without any problems. The process can be completed in a short amount of time. However, if you have any problems with the domain transfer because of incomplete or unclear data, then your old provider may initially reject the transfer. In such a case, contact the old provider as soon as possible. The current provider can only accept the transfer once there are no further uncertainties.

IPS tag: If you want to transfer your .uk or .co.uk domain to plentymarkets from a different domain provider, you need to have your current domain provider adapt the IPS tag in advance. Our domain provider’s IPS tag is:

UNITEDDOMAINS-DE

Configure CNAME Records

A Canonical Name or CNAME record is a type of DNS record that links an alias name to another canonical domain name. For example, you can use it along with the provider Shopgate to create a mobile version of your online store or you can use it to set up an external email service.

This is done by entering a source and a target. In the example, the source mobile.your-shop.com is the mobile version of the domain your-shop.com. Use the Shopgate subdomain cname.shopgate.com as the target. This CNAME entry ensures that your store will have the correct resolution with Shopgate.

Configure TXT Records

Use the TXT Resource Record to save a user-definable text within a DNS zone. This can be done for your main domain as well as for all sub-domains of your online store. For example, email or newsletter service providers may require such entries. Your service provider will give you the data to be entered.

This is done by entering the data that you received from the service provider.

Configure your own name servers for subdomains

Here you’ll enter one or more name servers for a sub-domain. This is done by entering the sub-domain and the domain name of the target server. Please note:

You can only save name servers for sub-domains of a main domain.
You can enter multiple name servers for a sub-domain. Simply click on the plus symbol again.
Enter the name server’s domain name.

URL forwarding

Here you can set up forwarding for an extra charge. This is done by entering redirect information into the designated field. You can define one redirect per line. Note the following syntax information while entering redirects. Changes will be published on the web servers within 24 hours.

Note: Redirects will not be used if they contain a file extension (e.g. index.php, myFile.pdf, etc.).

Structure

Redirects always consist of four parts that are separated by semicolons:

Source;Target;HTTP-code;Option

Part Explanation

Part	Explanation
Source	The source path you want to forward from (e.g. `/contact/`). Use an asterisk `` at the end of the source if you want all of the subpages to redirect to the target (e.g. `/contact/`).
Target	The target path or target URL you want to forward to (e.g. `/company/contact/` or `http://www.external-domain.com/contact/`).
HTTP code	The following HTTP codes are supported and interpreted by search engines: 301: The requested source is now available at the defined target (also called redirect). The old address (source) is no longer valid. 304: The contents of the requested resource have not been modified since the last client query. Therefore, the contents are not retransmitted.
Option	You don’t always need to specify an option. L: If you specify this option, no additional RewriteRule is run after this one.

Source

The source path you want to forward from (e.g. /contact/). Use an asterisk * at the end of the source if you want all of the subpages to redirect to the target (e.g. /contact/*).

Target

The target path or target URL you want to forward to (e.g. /company/contact/ or http://www.external-domain.com/contact/).

HTTP code

The following HTTP codes are supported and interpreted by search engines:

301: The requested source is now available at the defined target (also called redirect). The old address (source) is no longer valid.
304: The contents of the requested resource have not been modified since the last client query. Therefore, the contents are not retransmitted.

Option

You don’t always need to specify an option.

L: If you specify this option, no additional RewriteRule is run after this one.

Examples

Redirect Explanation

Redirect	Explanation
`/mens/*;/fashion/mens/;301;L`	All URLs that start with `/mens/` are forwarded to the URL `/fashion/mens/`.
`/mens/trousers/;/fashion/mens/trousers/;301;L`	The URL `/mens/trousers/` is forwarded to the URL `/fashion/mens/trousers/`.
`/mens/basics-;/fashion/mens/;301;L`	All URLs that start with `/mens/basic` are forwarded to the URL `/fashion/mens/…`. *Note:* In this example, the part of the source URL that starts with `basics-` is appended to the target URL.
`/;https://www.external-blog.com/;301;L`	The homepage is forwarded to the URL `https://www.external-blog.com/`.
`/*;https://www.external-blog.com/;301;L`	All URLs, including the homepage, are forwarded to the URL `https://www.external-blog.com/`. *Note:* Never set this redirect for your main store. Otherwise the plentymarkets admin will no longer be accessible. However, you can use this redirect for additional clients (stores) without any problem.
`/blog/*;https://www.external-blog.com/;301;L`	All URLs that start with `/blog/` are forwarded to the URL `https://www.external-blog.com/`.
`^/fashion/trousers/$;/fashion/mens/trousers/;301;L`	This rule only applies to the address `your-domain.com/fashion/mens/` without anything before or after. The circumflex `^` symbolises the beginning of the string and the dollar sign `$` symbolises the end of the string. Use this syntax if you have multiple lines of redirects that have e.g. `/fashion/trousers/` as the source URL and you want to avoid undesired redirects or endless redirects.

/mens/*;/fashion/mens/;301;L

All URLs that start with /mens/ are forwarded to the URL /fashion/mens/.

/mens/trousers/;/fashion/mens/trousers/;301;L

The URL /mens/trousers/ is forwarded to the URL /fashion/mens/trousers/.

/mens/basics-*;/fashion/mens/*;301;L

All URLs that start with /mens/basic are forwarded to the URL /fashion/mens/….
Note: In this example, the part of the source URL that starts with basics- is appended to the target URL.

/;https://www.external-blog.com/;301;L

The homepage is forwarded to the URL https://www.external-blog.com/.

/*;https://www.external-blog.com/;301;L

All URLs, including the homepage, are forwarded to the URL https://www.external-blog.com/.
Note: Never set this redirect for your main store. Otherwise the plentymarkets admin will no longer be accessible. However, you can use this redirect for additional clients (stores) without any problem.

/blog/*;https://www.external-blog.com/;301;L

All URLs that start with /blog/ are forwarded to the URL https://www.external-blog.com/.

^/fashion/trousers/$;/fashion/mens/trousers/;301;L

This rule only applies to the address your-domain.com/fashion/mens/ without anything before or after. The circumflex ^ symbolises the beginning of the string and the dollar sign $ symbolises the end of the string. Use this syntax if you have multiple lines of redirects that have e.g. /fashion/trousers/ as the source URL and you want to avoid undesired redirects or endless redirects.

8. Deleting or cancelling domains

Go to Setup » Assistants » Basic setup.
Click on the domain assistant.
Click on Delete () in the upper right corner of the box.

Cancelling the main domain

Only cancel your main domain if you also want to cancel your plentymarkets system’s contract. Otherwise, save a new main domain.
If you want to cancel your system contract, please note the cancellation deadlines. If you cancel your main domain too early, the domain’s contract might end earlier than the system’s contract. The system will no longer be available in this case, even though the contract has not ended yet.

Cancelling a client

If you cancel a client, the domains associated with this client are also cancelled. To continue using these domains, link them to a different client.