All help articles

Commerce

Set up a public directory

Add public business entries manually or from a document, then review and publish the directory.

Updated 7 November 2026

Use a public directory to help customers find businesses and read their public descriptions, addresses, phone numbers, email addresses and websites.

Public business entries belong to the directory. They do not become your branches or pickup places. Your own physical places stay in Settings → Business profile → Other locations and can also be selected for a directory.

Each entry uses its own website. If none is supplied, the directory shows no website link; it never substitutes your Business Profile website. For a selected location, set its website in the location editor. Saving the address does not scan or import the website into Knowledge.

Add public businesses

  1. Open Catalog, choose a type, category or saved item, then Tools.
  2. Choose Public directory → Create Tool, then name the directory.
  3. Under Public business entries, choose Add business. Enter the business name and any approved public description, category, address and contact details.
  4. On Web, choose Save entry or Cancel before saving the Tool. On Mobile, edit the entry fields in the Tool setup. Removing an entry requires confirmation and changes only this draft.
  5. Explain what customers should know about the results, then save the Tool draft.
  6. Review the entries and affected items, then publish. Publishing requires Catalog publishing permission.

Use up to 150 public entries and selected business locations in total. Only include details approved for public use. Leave unknown details blank.

Import a document

  1. Under Public business entries, choose Import from document.
  2. Upload a PDF, Word document, Excel workbook or CSV file with readable business details.
  3. Review the proposed entries against their quoted source. Possible duplicates start unselected. Pictures inside a document are not read.
  4. Choose Add selected entries to add them to the Tool draft. On Web, use Edit to correct details or Set on map to choose an address and pin. On Mobile, edit the added entry's fields in Tool setup.
  5. Save the draft, preview it and review the entries before publishing.

Document import uses AI credits on Web and Mobile. The review is saved in your Qyra task history. Choose Resume import to reopen a recent saved directory review without uploading or paying for another extraction. Saved selections are checked against the current document before they are added. If the source has changed or is no longer available, import it again. Approving an import plan in Qyra still leaves the Tool draft to be saved and published.

Importing does not publish entries or create your business locations. A file that cannot be read completely must be split into smaller files or entered manually. Claims about services, participation and coverage need their approved records; importing a document does not verify them.

Include your business locations

After saving the Tool, use Add items under Your business locations on Web, or choose the locations in Mobile setup. Each selected place must be active and visible to customers. Changes to these places stay with the Business Locations owner; the directory reads their current approved details.

Preview and use it

The preview shows a directory list. On Web, use Search directory to find matching names, descriptions, categories, addresses and contact details. A saved map pin can provide directions. An address without a pin is still a useful public detail; it is not a verified map position.

Save changes and reopen the draft to review them. A draft does not change a published directory until you publish its reviewed revision. Reusing the Tool on another item requires adding it there or using that item's shared type or category settings.

Customer Qyra, Bots and linked Forms use the same published Tool settings where their setup allows it. Publishing does not independently enable a customer channel or perform a business action.

What a listing confirms

A listing supplies public information. It does not confirm that your organisation owns the listed business, that a hospital accepts a particular plan, that a place offers a specific covered service, or that capacity is available now. Confirm those facts through the responsible business or an approved connected service.

If an entry does not appear

  • Check that the Tool is published, enabled here and within its dates.
  • Check that the item is published and available.
  • Check that the directory has at least one public business entry or selected business location. An empty draft cannot be published.
  • For selected business locations, check that the place is active and visible to customers.
  • After a save or publication interruption, reopen the existing draft or reviewed change before creating another Tool.

See Set up Catalog tools for versions, shared settings and Tool connections.

Was this article helpful?