Troubleshooting Speks

Why do I get a blank page when clicking a link to a Spek? 

⚠️ Cause: You are most likely not a member of a Team that has access to the Topic the Spek belongs to.

✅ Resolution:Follow these troubleshooting steps:

1. Verify the Teams your member belongs to.

2. Find the Topic that the Spek belongs to.
3. Edit the Topic and check the Teams that can access this topic.
4. Ensure your user is a member of one or more of those Teams.

What to do when Spek URLs are not loading from a Word Doc?  

🔍 Scenario: Unable to open SPEK URL GOES HERE. The pop-up ‘The internet site reports that the item you request could not be found. (HTTP/1.0 404)’ appears. 

• Error message when selecting a hyperlink in Office: "Cannot locate the Internet server or proxy server": https://docs.microsoft.com/en-us/office/troubleshoot/office-suite-issues/cannot-locate-server-when-click-hyperlink
• Secondary link: https://answers.microsoft.com/en-us/msoffice/forum/all/microsoft-hyperlink-not-working-on-some-url/75f89bf9-9842-4fb9-9195-cc9fb50e60e7

✅ Resolution:This issue must be resolved by your internal IT team. Submit a ticket to IT to review Office hyperlink, proxy, and security settings.

What to do when Spek icons are not appearing in Salesforce? 

✅ Resolution:

• Verify they are using Google Chrome or Microsoft Edge as their browser.
• Verify the Spekit Chrome extension is installed, enabled and logged in.
• Refresh the web page.
• If you created a custom Spek, verify the Spek is related to the appropriate Object and the Topic is assigned to your Salesforce URL.
• If the text is on a VisualForce page there might be an iframe URL that needs to be enabled for Spekit icons. Get the URL of the VisualForce page and send it to Spekit Support to add to the auto-enabled URL list.

What to do when Spek icons are not appearing for my Viewers on other web tools? 

✅ Resolution:

• Verify they are using Google Chrome or Microsoft Edge as their browser.
• Verify the Spekit Chrome extension is installed, enabled and logged in.
• Verify the user is in a Team that is assigned to the Topic.
• Verify the Topic that contains the Speks is assigned to the URL of the web tool.
• Verify the text on the page matches exactly to the "Label" field of the Spek.
• Check if the page contains an iframe: 
  • To determine if the text is in an iframe, right-click on the text where the Spek icons should appear. If you see "View Frame Source" as an option then the text is in an iframe. The iframe URL needs to be enabled for Spekit icons. 
  • Get the URL of the iframe page and send it to Spekit Support to add to the auto-enabled URL list.

Why are Spekit icons not showing up?

✅ Resolution:If you don't see the Spekit icon please check you have the following:

1. Make sure you have a definition saved for the term in order for the visual cue icon to show up next to it. 
2. If in Salesforce, make sure you've imported the object you're documenting. 
3. To define objects, fields, and picklists in Salesforce, make sure you define the associated Spek type.
   • For example, the Lead Source field will already have an undefined Spek placeholder for you if you've imported the Lead Object.
   • You don't need to create a Custom Spek for any imported object, field or picklist value in Salesforce - simply highlight the label, and type "S" on your keyboard. This will pull up the correct Spek for that field.
   • You can then click into it and define it.

If you are not in Salesforce, make sure Spekit icons are enabled on the website. Please note that this feature is limitedly compatible with certain web applications, such as Adobe Workfront.

What to do when a Spek is not loading from an internal link?  

🔍 Scenario: I'm clicking on the internal Spek link, but the wiki never loads.

✅ Resolution:If you're facing the issue above, it's most likely a cache issue:

1. Copy and paste the following into your Chrome browser address bar: chrome://settings/clearBrowserData
2. Choose time range - Last 4 weeks,
3. Select Cookies and other site data.
4. Select Cached images and files.
5. Click the Clear data button.
6. Close (all tabs) in Google Chrome and open a brand-new session.
7. Go to the Spekit Web App and log in.
8. Open a Spek and click on a linked Spek and it will open now.

Contact Spekit Support

• Email: support@spekit.co
• Standard Support Hours: Monday–Friday, 7:00 AM – 4:00 PM PT
• Emergency/Outage Support: 24/7/365