Continuation of Install Commerce Categories Migration Tools
4. Set Field Mapping
The following tables list the Commerce Category fields that can be set at the time of the category import.
If the column names in the header row of the Commerce Category import file use the internal IDs of the Commerce Category fields, the tool attempts to map the fields automatically. Sublist fields are displayed with the sublist name in parenthesis appended to the field ID.
Categories
The following table lists the available Commerce Category fields:
| Label | Internal ID | Notes | Required |
| Addition to <head> | addtohead | This field lets you specify code, such as HTML, CSS, or JavaScript, to include between the <head></head> tags on the category page. | No |
| Catalog | catalog | Internal ID of the Commerce catalog record. Each site can have one catalog, and all categories are assigned to that catalog. The catalog is at the top of the hierarchical structure of categories. | Yes |
| Creation Date/Time | created | – | No |
| Description | description | Description of the record. | No |
| Display in Web Site | displayinsite | Specifies if the category is available to visitors to your website. | No |
| Inactive | inactive | Mark a category as inactive when you want to prevent it from displaying on your website and prevent any other activity from occurring with that category. | No |
| When a category is inactive, it cannot be assigned as a subcategory of another category. You cannot mark a category as inactive if it has subcategories assigned to it. When a category is marked as inactive, it is omitted, by default, from the Commerce Categories list. | |||
| To include inactive categories in the list, check the Show Inactives box on the Categories List page. | |||
| Last Modified | lastmodified | – | No |
| Modified By | lastmodifiedby | – | No |
| Meta Description | metadescription | The description you enter for this field is an important SEO consideration because it is normally the description that is included on search results pages. | No |
| Meta Keywords | metakeywords | Meta keywords for the web page. | No |
| Name | name | The name of the category record. | Yes |
| Page Banner | pagebanner | Image file in the file cabinet that can be displayed as the banner on a category page on an SuiteCommerce website. The page template file must be configured to display the banner image. | No |
| Heading | pageheading | The heading displayed at the top of the category page. The page template must be configured to display the heading. | No |
| Page Title | pagetitle | The title of the page. The value of this field populates the <title> element for a category page. | No |
| Primary Parent | primaryparent | If you are creating a subcategory, select the primary parent category to which this subcategory should be assigned. The new category is assigned as a subcategory for the parent category specified here. | No |
| Leave this field empty if you do not want to assign a primary parent category. | |||
| When a subcategory is assigned to multiple parent categories, you create a scenario where duplicate content can be accessed through multiple URLs. For SEO best practice, the primary parent flag is used to build the canonical link tag which tells web crawlers that this is the preferred URL for accessing the content. | |||
| Sequence Number | sequencenumber | This number controls the order of how categories are displayed in Site Management Tools (SMT). If you leave this field empty, sequence numbers are assigned automatically based on any manual ordering of categories in SMT. | No |
| Sitemap Priority | sitemappriority | This value populates the <priority></priority> element in an XML sitemap. Valid values for the priority are 0.0 to 1.0. If no priority is set in the sitemap, then the default priority of 0.5 is used. | No |
| Sitemap priorities let you rank the importance of the pages on your website as they relate to each other. Search results pages may consider this ranking when presenting multiple pages from your site and order the pages based on the priority. | |||
| Start Date | startdate | This field identifies the start date and time for the record you are viewing. If this is a future date, the content does not display until that date. See the help topic, Visibility Dates. | No |
| Enter the date and time in the same format as specified in your preferences. | |||
| Thumbnail Image | thumbnail | File in the file cabinet used to display as the thumbnail image for this category. | No |
| URL Fragment | urlfragment | This field specifies the section of the URL used to go to the category page. The fragment does not include slashes. | Yes |
| Version | version | – | No |
Subcategory Sublist
The following table lists the available Commerce Category subcategory sublist fields:
| Label | Internal ID | Notes |
| Addition to <head> Override | addtoheadoverride | – |
| Description Override | descriptionoverride | – |
| Display in Web Site Override | displayinsiteoverride | – |
| Meta Description Override | metadescriptionoverride | – |
| Meta Keywords Override | metakeywordsoverride | – |
| Name Override | nameoverride | – |
| Page Banner Override | pagebanneroverride | – |
| Heading Override | pageheadingoverride | – |
| Title Override | pagetitleoverride | – |
| Sitemap Priority Override | sitemappriorityoverride | – |
| Subcategory | subcategory | Internal ID of a Commerce Category. This field is required. |
| Thumbnail Image Override | thumbnailoverride | – |
| URL Fragment Override | urlfragmentoverride | – |
Items Sublist
The following table lists the available Commerce Category items sublist fields:
| Label | Internal ID | Notes |
| Items | item | Internal ID of an item. This field is required. |
| Primary Category | primarycategory | – |
| Sequence Number | sequencenumber | – |