Item Name

Item Name is used in your Product Archive / Search Pages.

You want to keep it short but descriptive, as this is the first description a customer will see. 

 

The character limit for this field is 255 Characters.

Item Short Description

This description will appear on the Product Single View Page.

It gives a longer summary of what the product is about.

 

The character limit of this field is 500 characters.

Item Long Description / Memo

This is used to give as much information as possible about the product.

Be careful of using this, especially when copying data from another website.

As most data from other websites are contained within HTML you are copying that HTML code over without realising it.

This could hurt both consistency on your site how this description is rendered (and even in some cases break your themes layout altogether) as well as your SEO score if the wrong Tags are used. (Especially in cases where H1, H2 or H3 tags are used)

You can also input images here but I highly discourage this.

 

If you are unsure the best course of action will always be the click on the "Show Source" button and then paste your data as this will paste it without HTML formatting (If you copied what looked to you like text only)

You can then click on that button again and modify the line breaks, bulleting etc.

<h> Tags for WooCommerce

When it comes to SEO and accessibility best practices for a WooCommerce single product page, using proper HTML heading tags (<h1>, <h2>, etc.) is important for both user experience and search engine crawling.

Here's a breakdown of how heading tags should ideally be structured on a single product page in WooCommerce:


Recommended H Tag Structure for Single Product Page:

<h1> — Product Title

  • Purpose: This should be the only <h1> on the page and should contain the product's name.

  • Example:

     
    <h1 class="product_title entry-title">Awesome T-Shirt</h1>

<h2> — Section Headings (Main content areas)

  • Used for:

    • Product summary or description

    • Additional Information

    • Reviews

  • These should all be at the same hierarchy level.

  • Examples:

     
    <h2>Description</h2> <h2>Additional Information</h2> <h2>Reviews</h2>

<h3> — Sub-sections inside those <h2> sections

  • Inside description or review tabs, if there are sub-sections (e.g. materials, size guide, etc.), use <h3>.

  • Example:

     
    <h3>Material & Care</h3> <h3>Size Guide</h3>

<h4> and below — Only if needed

  • Deeper content nesting, such as points within tabs, FAQ sections, or in detailed review breakdowns.


Bonus Tips:

  • Don't skip levels (like jumping from <h1> to <h4>).

  • Avoid using heading tags for styling alone (use CSS classes instead).

  • Make sure there is only one <h1> on the page for SEO clarity.

  • Use consistent heading structure site-wide for a strong SEO foundation.


WooCommerce Default Behavior:

Out of the box, WooCommerce usually wraps the product title in <h1>, and the description/review tabs are often in <h2> or <h3>, depending on the theme. But it’s theme-dependent, so always inspect the source or override templates if needed.

Product Images

Can be found on the Product, on the Picture and Memo Tab.

Use the Images button.

From here you can browse to an image on your PC, copy an image from your clipboard or even scan in an image.

You can add as many images as you want but remember the more images you add the more resources will be used to open this Product Page.

You can set the Order of the Image and even use the Description to describe the image (Used in WooCommerce as the Alt Image Tag)

The recommended resolution is 800 x 800 pixels, 72dpi and the image format recommended is jpg.

This will keep the images small and the viewing experience consistent.

Product Brands

Can be found under the Tab Stock Items, Extra, Tables, Brands.

If you previously used Brands within Smart-IT and do not see anything listed here use the Auto Create Brands Button to populate the Brands.

From here you Add or Edit a Brand .

Name would be the name of the brand.

Description would be the slogan of the brand or a description of the Brand. It is limited to 255 Characters.

Logo Image would be the brand logo.

The recommended resolution is 400 x 200 pixels, 72dpi and the image format recommended is jpg.

This will keep the images small and the viewing experience consistent.

The Items can be setup on the product page, under the Additional Info Tab using the Brand name Search button.

Alternatively you can use the Bulk Change Selected in Extended Item Lookup to apply a brand to multiple items.

Payfast

Payfast Bank Ledger Account

 

We need to setup Payfast as a Bank on our Ledger

Click on the Ledger Tab and then on the Account Setup Icon.

Click on Add New Main Account and type the following Information:

Description: Payfast

Account Type: Bank

Default VAT: Not Applicable

Allow Post: Ticked

Reconcilable: Ticked

 

The account is now ready to be used.

 

You can allocate payments 3 different ways

  • When transferring a Sales Order to an Invoice, Select Direct Bank /EFT option and Choose Payfast on the Bank Account Dropdown (This is in the Payment Screen)
  • On the Sales Order you can also already allocate the payment if desired. While the sales order is open click on the Extra dropdown menu and click on Customer Payment/Deposit. Again fill in the amount in the Direct Bank / EFT and choose Payfast under the Bank Account dropdown menu.
  • If you already processed the Invoice under account you can go to the Customer Tab and click on the Receive Payment icon. Choose the customer. Again fill in the amount in the Direct Bank / EFT and choose Payfast under the Bank Account dropdown menu.

Shopify

Menu Generation (From Smart-IT - Use with caution as this will delete your current menu!)

 

On Shopify go to

Apps and sales channels > Develop Apps

Choose the App Developed by Smart-IT

Click on the Configuration Tab

Click on the Edit button next top Admin API integration

 

 

Online Store navigation

View menus for display on the storefront

Tick write_online_store_navigation

Tick read_online_store_navigation

 

Click on the Save button

 

You should now be able to use the Generate Menu button on the Shopify module within Smart-IT.

WooCommerce Variable Items not correctly syncing

If a website is new there might have been issues when the developer initially setup the site.

This causes the variable items no pull in under its master but not correctly assigning to the desired attribute.

To fix the issue

  1. Delete all products on WooCommerce
  2. Delete all products in the WooCommerce Bin
  3. Go to the WooCommerce Menu and click on the Status Option
  4. Go to the Tools Tab
  5. You will see an Option "WooCommerce transients This tool will clear the product/shop transients cache." 
  6. Click on the Clear transients button next to it
  7. Wait for the process to finish.
  8. You will also see an option "Orphaned variations This tool will delete all variations which have no parent."
  9. Click on the Delete orphaned variations button.
  10. Wait for the process to finish.
  11. Go to Products, Attributes and delete all the attributes.
  12. Now do a full sync from Smart-IT and the variations should be corrected.
  13. If the problem persists it is caused by a plugin.
  14. Disable 1 plugin at a time and repeat steps 1 - 12 until you find the plugin that causes the issue.
  15. Please report to us the plugin that caused this behavior.

Smart-IT WooCommerce not correctly syncing

If a website is new there might have been issues when the developer initially setup the site.

 

To fix the issue

Check that you can access the following page (Replace YOURURL with your domain)

https://YOURURL/wp-json/wc/v3/settings/general

 

Example

https://woocommerce.smartaccounting.co.za/

would be

https://woocommerce.smartaccounting.co.za/wp-json/wc/v3/settings/general

 

If you get an error 443 error (as shown below) then your hosting provider needs to open the Port or make changes in the Firewall.

 

Not Found
The requested URL was not found on this server.
________________________________________
Apache Server at YOURURL Port 443

 

When you get an 401 error (as shown below) then you know you are on the right track and can retry Syncing from Smart-IT.

 

{"code":"woocommerce_rest_cannot_view","message":"Sorry, you cannot list resources.","data":{"status":401}}