--- schema_version: "1" id: 6bf7aa655d8bb7901e51809b8d0633239946b0e1a9e1035ebc7334f373245bba title: Migrate a Koa or Kokua Site to a New Template collection: admin version: current locale: en-us portal_url: https://docs.salesforce.com/admin/current/en-us/experience/264-0-0/networks_migrate_from_koa_kokua.md canonical_url: https://help.salesforce.com/s/articleView?id=experience.networks_migrate_from_koa_kokua.htm&release=264.0.0&type=5 source_site: help.salesforce.com content_type: documentation content_hash: a09e96e859cf7928dfa998f9f641cfc60baf405a880601a835a607ce41cfcd68 description: The Koa and Kokua templates are retired, and you can no longer use them to create site. Salesforce supports existing sites built with Koa and Kokua, but we recommend migrating to newer templates. The new templates provide richer support for Salesforce Knowledge and case management, and they also receive updates and new features with each release. products: - Experiences release: "264" --- # Migrate a Koa or Kokua Site to a New Template The Koa and Kokua templates are retired, and you can no longer use them to create site. Salesforce supports existing sites built with Koa and Kokua, but we recommend migrating to newer templates. The new templates provide richer support for Salesforce Knowledge and case management, and they also receive updates and new features with each release. **Migration Options** Because your Koa and Kokua sites aren't using the latest Lightning technology, we recommend creating a new site. A new site reflects the most recent innovations and features. You can choose to migrate your site using the **Change Template** button from **Workspaces** | **Administration**. If you do, the migrated version won’t reflect all the innovations made to the product. To determine which template is right for your use case, check out [Which Experience Cloud Template Should I Use?](https://help.salesforce.com/s/articleView?id=experience.siteforce_commtemp_intro.htm&release=264.0.0&type=5 "Experience Cloud templates let you build responsive sites for delivering rich, branded spaces for your customers and partners. And with Experience Builder, you can accomplish a lot without coding. For example, you can edit a template’s components to include information about your site, add images to extend your branding, and include CMS content. And if you want a more customized experience, you can create custom pages, add components to pages, build custom Lightning components, and expose more Salesforce objects."). Also think about what you envision for the future. If your use case is strictly a help forum, consider using the Help Center template. Otherwise, consider the Customer Account Portal as an option. ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-experience-communities-264-0-0-production-enus/bf7df212-91a1-4fa3-a007-4d6f3e3b470b/images/icon_note.png) Note Always test your implementation first in a sandbox before publishing your new site. See [Deploy an Experience Cloud Site from Sandbox to Production](https://help.salesforce.com/s/articleView?id=experience.networks_migrate_overview.htm&release=264.0.0&type=5 "We recommend creating, customizing, and testing your Experience Cloud site in a test environment, such as a sandbox, before deploying it to your production org. When testing is complete, you can use change sets or Metadata API to migrate your site from one org to another. Deciding whether to use change sets or MD API depends on several factors. Some things to consider are the complexity of the changes that you’re migrating, your level of comfort with developer tools, and the application lifecycle management (ALM) model that you’re using."). Your Koa or Kokua site allows you to expose your Salesforce Knowledge implementation to the world while giving users the chance to file cases. The Customer Service template lets you do both. But it also lets you do other things, such as add Chat capabilities or the potential for customers to edit their cases. If the Customer Service template’s extra features are more than you need, you can remove unnecessary pages and components. **Filtering in Searches** Koa and Kokua searches allow users to filter by article type and category. These filtering options are only available in the Koa and Kokua templates. However, you can scope searches to specific topics and see all articles associated with that topic. You can also look for search components created by trusted Salesforce partners and distributed via AppExchange. **Data Categories Versus Topics** Your Koa or Koa site uses your Salesforce Knowledge setup and data categories to organize content. The Customer Service template also uses Salesforce Knowledge in the back end to organize content, but in the site, content is organized using topics. You can map the articles in your data categories to topics in a site. To map articles to topics automatically: 1. Select **Experience Workspaces** | **Content Targeting** | **Automatic Topic Assignment**. 2. Enable **Automatic Topic Assignment**. 3. Map topics to data category groups and data categories. You can choose to add the topics to all existing articles and articles added in the future. Because data categories aren’t the primary content organization scheme in the Customer Service template, you can’t use the following components. - Article Type Filter - Category Filter - Category Navigation - Expanded Category Navigation - Featured Data Categories - Featured Search - Trending Articles You can map your exact hierarchy from data categories to topics, up to eight levels of depth. **Data Category Permissions** Thoroughly check the data category permissions for all profiles accessing your newly built site. If you add new profiles and users to your site, check that all the articles’ data categories are set to the right permissions for your users. In particular, check the permission on the [guest user profile](https://developer.salesforce.com/docs/atlas.en-us.community_templates.meta/community_templates/rss_config_guest_user_profile.htm) for each site. **Viewing Articles** The Article Listview and Article Home components are only supported in the Koa and Kokua templates. Use the Top Articles by Topic component for a list view in a Customer Service community. When you click a topic in the Top Articles by Topic component, you see the topic detail page with a list of articles for that topic. **Left-Hand Navigation** Use [custom themes](https://help.salesforce.com/articleView?id=community_builder_theme.htm&language=en_US) to replicate the left-hand navigation scheme seen in the Koa and Kokua templates. **New URL** Your new site’s URL is different from your old Koa or Kokua URL. Give your customers a smooth transition from one to the next by following these steps. 1. In your Koa or Kokua site, select **Workspaces** | **Administration**. 2. Click the pencil button, and change the site’s URL. 3. Click **Save**. 4. In your new site, select **Workspaces** | **Administration**. 5. Click the pencil button, and change the community’s URL so that it matches your old URL. 6. To handle bookmarked articles, [consider rewriting your site URLs](https://developer.salesforce.com/docs/atlas.en-us.apexcode.meta/apexcode/apex_site_urlRewriter.htm). ![Important](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-experience-communities-264-0-0-production-enus/bf7df212-91a1-4fa3-a007-4d6f3e3b470b/images/icon_important.png) Important Change the URL only after testing that your new site works just as you want it to.