Attachment visibility

Once you’ve added your attachments, make sure to check the Display Attachments option on the article form. Otherwise, you may have a great context-adding attachment, but if customers/users are unable to see it, it’s not very helpful. Checking this box allows the attachment to be visible to your customers/users.

Remember that they're searchable

Keep in mind that attachments are searchable so make sure:

• they are relevant
• they contain only appropriate information for the audience
• they are not overly broad

Edit your attachments like you would your article

With attachments, review what’s in them to make sure that items attached to Public articles contain only information suitable for an external audience. Also, review the attachments to verify there is no customer information or internal information such as internal server names, URLs, or employee logins, and so on.

Utilizing Script or XML files

If your attachment is a script or XML file, make sure for Public articles that it is runnable externally. Also, double-check that it does not contain any internal references such as internal server or employee names.

Attachment file names

Just like you wouldn’t title your article with “Article title,” use meaningful names for attachment files rather than generic descriptions.

How not to name your files:

• "pastedimage1.png"
• "Screen Shot 2017-12-18 at 3.05.35 PM.png"
• "NewScript.xml."

This enables your users/customers to clearly identify the attachments they would like to view. A better example might be "TransitionScript_063018."

Screenshots or not?

Screenshots can help readers more quickly understand a location in the interface or an illustration of the issue, by pointing it out instead of them having to search for it. Here are some things to keep in mind when considering screenshots.

Screenshot non-searchability

While attachments are searchable, screenshots are not. Make sure that you are not using them to substitute for text explanations. For this reason, they should be context-adding and not context-replacing.

Duplications

Do not include numerous callouts that repeat or are substitutes for sequential actions.

Make it legible

Sizing your image so that it does not require too much horizontal scrolling limits your customer or user frustration.

• Try making the image as small as possible while still illustrating the necessary area in order to maximize impact.
• Consider cropping images to be able to enlarge and emphasize the specific area relevant to the issue.

Include buttons and icons

Insert graphic attachments in the text and do not reference them via URL. This might be helpful when trying to direct a customer/user to a specific button or icon to click, showing them the image in the text.

Keep certain information out

Although screenshots should be context-adding, make sure they do do not contain any customer information or internal information such as employee login names, URLs, and so on. 8 Tips to Help Improve Content in your Knowledge Base will help you keep your content audience-friendly.

----

Well that does it on our tips for screenshots and attachments. Makes sense, right? Stay tuned for what's next: Tips on Writing Guidelines on Steps to Reproduce.