Are there best practices for linking directly to articles from within a localized SaaS product?

Hey @user892​, have you configured your Help Center yet to be multilingual so as to have articles in both English and Japanese? You'll need to manually write and translate these, but it'll allow for easy linking.

I inherited it, so I assumed it was configured correctly. There are versions for the two languages, but the displayed url includes the japanese or english article title. that would imply that the in-product links pointing to the articles would need to be localized. is there an indicator that would definitively indicate correct configuration?

This is expected behaviour. Each language version would have a separate URL, but this URL is automatically generated based on the title of your article.

Cool. That's why I was asking for best practices. So the URLs need to be treated as strings and localized with the rest of the UI, yes?

Sorry, I'm not quite sure what you mean by "localized within the rest of the UI". Do you mean within the Help Center UI or elsewhere on your site/app?

Hi @user892​ 👋,

As @eric f11​ mentioned, each language version has a separate URL. Does this complicate the linking process?

Like if there were help.domain.com/en/103 and help.domain.com/ja/103 - The linking process be easier?

In your case it depends how you where would you like to link articles:

1) Every product feature page, like Intercom?

2) Inside some text information (like Blogs...)?

I will suggest one workaround, you can use Article inserter and display articles inside your Intercom messenger:

Articles can be displayed based on different conditions (like - User Language, Current page URL, Current plan and etc):

Once you set-up all the following, you can open Intercom messenger instead of linking Articles one by one.

Let me know if you have any further questions, Will be more than happy to provide more information.

Within our app. We are embedding links to articles in our screens. Those links will have a localized article title. Normally, there is just the string to translate. In this case, there is the link string to translate (e.g., Learn more). But with the underlying URL needing to be handled for translation, I'm assuming the URL would be treated like the string, as well.

i was hoping someone would say that :-)

Ha - thanks for cutting through my extra questions and providing the clarity that was needed, @user382​ 😄

here to help!