Cross-Site Links

Validation Issue: Most likely you observed this issue when opening the affected content in CoreMedia Studio. It will tell you about links that refer to other sites, ignoring the master link that is meant to link to other sites.

Confused Site Visitors: Your site visitors will experience switching between languages accidentally just by navigating through your site.

Manually Copy Contents Between Sites: Despite the most obvious reason, that you may have manually added links from other sites, the more likely reason may be copying contents between sites. If you do so, there is no feature, which will map contained links, as it will be done in translation and synchronization workflows. Thus, instead of links pointing to the site you copied to, the links will still refer to the source site you copied from.

Manually Copy Richtext Between Sites: A similar, may be less obvious cause, is copying Richtext contents from one site to another. They may contain embedded images as well as internal links. On copy & paste these images/links will still link to the originating site.

Workflows Not Updating Links: From a translation or synchronization workflow perspective, these links most likely will be considered as independent links in a derived site, thus, as if they have been explicitly added in the derived site. These links will never get updated by translation or synchronization workflows, they may even cause conflicts when trying to merge changes to the affected link lists.

This effect will only occur, if you have explicitly set a master-link. Note, that in case of copy & paste master-links and master-versions will be removed, if set.

Delivery Issues: Depending on your delivery configuration, you may experience either broken links or (more likely) your visitors stumbling from one language to another without being aware of it.

Remap Links Manually: If recreating the content from master is not an option, you may manually remap the links to link to the same contents in the actual site. Note, that this applies to link lists, to links and embedded images in CoreMedia Richtext just as links set in Struct properties.

Use Workflows: Instead of manually copying contents from one site to another, use workflows such as translation or synchronization workflow (whichever applies). Workflows will take care of mapping the links to the corresponding sibling in the target site. In addition to that they will also create possibly missing link targets in derived sites.

Remap Links Manually: Just as stated above, if you copied contents or property values such as CoreMedia Richtext from one site to another, you have to manually remap the links accordingly. Note, that this may not be feasible in CoreMedia Studio, as not necessarily all links are accessible within CoreMedia Studio. If in doubt, please ask your administrators to check the content.

Deleted Master

Validation Issue Deleted Master: In CoreMedia Studio you will see an issue, that the master property refers to a non-existing master.

Deleted Master: Most likely, the master content got deleted. Unfortunately, there is not yet a way to propagate deletion of contents from one site to another. Thus, for a vivid site, it is likely that you will stumble across this issue.

No more updates: The content affected by deleted master will not receive any updates anymore. Most likely, as soon as all referrers have been updated, there will be no more content items linking to this content, and thus, you will have some content in your site unreachable by site visitors.

Despite this, the state is rather harmless and is similar to a content intentionally just existing in a derived site, but not in the master site.

Delete Derived Content: You may want to delete the derived content, just as the master content got deleted. Prior to that, you may want to run a translation or synchronization workflow for all contents linking to this content, as it is expected that any links will be automatically removed by this process.

Remove Master Link: Of course, if you want to keep this content, you can simply remove the master link. It is recommended to clear the master version property as well.

Restore Master: Always an option is to restore the master.

As there is now no way to propagate deletion of contents, there is no way to prevent this state, other than establishing a communication of site administrators of the master site to the local site administrators.

Duplicated Content Items

Some Document (1): In your derived site you may observe, that just next to your content Some Document another content named Some Document (1) exists.

Create With Same Name: You may have created a content with the same name, as it now exists in master site. When transferring the master content to your derived site, name conflicts are automatically resolved and the content from master will get a counter added to its name.

Manually Copy Between Sites: A typical pattern, which has been observed is that contents are copied manually between sites, instead of using the appropriate workflows.

Ignoring state may be an option: From the repository perspective you may safely ignore this state, as the name of the content is irrelevant for the Multi-Site feature to work. The relationship is always derived from the linked master content. But it may indicate, that a content receives translations, which is not even included in your site navigation.

If you continue working with these contents, only the content that links to the master via master-link will receive updates.

Fix Relation: If you expect that both content items are identical, you may need to resolve the conflict. Decide, which content item matches your desired content item best (most likely the one you already had in your site before).

Use Workflows: Instead of manually copying contents from one site to another, use workflows such as translation or synchronization workflow (whichever applies). Note, that this is only possible from master site to a directly derived site.

Adjust Localization Properties: If you need to copy a content to your derived site, ensure to adjust the localization properties. More specifically:

Invalid Master Version

Changes of Links Not Propagated: If you trigger a translation or synchronization workflow, you experience, that links changed in master do not make it to the derived content.

Unset Master Version: The master version property may be empty, that is unset. Technically, the field is set to null. This triggers the same behavior as:

Invalid Master Version: The master version may denote a version, which does not exist or does not exist anymore for several reasons. Negative values are valid, if their absolute value matches an existing version.

The actual cause of such states is unknown. It may be a special case of copy & paste between sites, but more likely any other tools that caused this invalid state. One example may be, that a version got destroyed by cm tools.

Properties Not Updated As Expected: For any property that is not meant to be translated, the expectation is, that it gets automatically updated from master. This feature is called auto-merge. This feature relies on the ability to determine, which properties have been changed from previous translation or synchronization to now. If the previous state of properties of the master cannot be determined because the master version is unset or not existing the defensive behavior of CoreMedia Multi-Site will assume no changes to apply.

Set Master Version: If you are lucky, you may guess an appropriate master version that matches the state of your derived content. If in doubt, set it to the current master version and review non-translatable properties such as links in differencing view.

If you have multiple contents in this state, consider setting it to the negative current master version. This way, you will have a kind of todo-list, as these contents will be listed as not translated yet.

Finish Workflow: Finishing a translation or synchronization workflow will adjust the version property automatically. This may be the easiest option to take, but you may miss contents you should have reviewed.

Handle With Care: As the actual cause is unknown, there is not much more to say than to handle the master version property with care. It contains important information, which, if invalid, may harm your translation and synchronization processes.

Any tooling and processes provided by CoreMedia respect these versioned references, so that they are not automatically cleaned up. The only difference is a tool called cm destroy, which is especially meant for administrative emergency interventions.

Locale Mismatch

Validation Issue: Most likely you observed this issue when opening the affected content in CoreMedia Studio. It will tell you about a mismatch between the site's locale and the locale set for the content.

Intended Behavior: This may be intended behavior, that is, you may want to provide a content with a different locale in the same site. Note, that due to current limitations of CoreMedia Multi-Site it is not recommended to use locales different to the site locale within a given site. For details see Effects.

Manually Copy Between Sites: A typical pattern, which has been observed is, that contents are copied manually between sites, instead of using the appropriate workflows. If doing so, the locale will not be updated accordingly.

Ignoring state may be an option: Using different locales within a site may be a valid option, if the following effects are not relevant to you.

Accidental Locale Clash on Derive Site: The effect is best described using an example: Think of a master site having locale en-US. This site contains a content D with German locale de-DE. If you derive a new site with German locale, the derived content D' will be perceived as having the site's locale. In the last step, you will derive a new site with Dutch locale nl-NL from the German site. As a result content D'' in the Dutch site will now be adapted to locale n-NL which may not be desired.

Figure 4.1. Conflict Site vs. Content Locale

In other words: If the site containing content D is a so-called leaf-site, thus, having no derived sites, and will never have one, there is no real issue having this content, unless you do translation via XLIFF:

Wrong Locale on Translation: Having a content D with locale de-DE in a site having locale en-US will result in XLIFF being generated with site-locale en-US. Thus, translation agencies will not be aware of the correct locale. This applies to the target locale as well as to the source locale.

Fix Locale: If you copied the content from another site, adjust the locale accordingly. It should be the same as the site's locale.

Use Workflows: Instead of manually copying contents from one site to another, use workflows such as translation or synchronization workflow (whichever applies). Note, that this is only possible from master site to a directly derived site. These workflows will automatically adapt the locale.

Adjust Localization Properties: If you need to copy a content to your derived site, ensure to adjust the localization properties. In this case:

Locale: Set the locale to the same locale as the site your content is in.

Removed Master Link On Copy

You copied a content and now see the hint "No master document has been specified".

When a content is copied in Studio, its master link is removed intentionally to maintain consistency and prevent further issues with localization.

If there is a respective content in the master site that should be referenced as master from the current content, you might miss updates if the reference is not added.

If there is a respective content in the master site, you should add a link to that using the appropriate version.

If the related master content can be identified by the system, as, e.g., by the same path relative to its site, you should see a suggestion in the issues for a master content.

If there is no respective content in the master site, nothing needs to be done.