# Troubleshooting Timeline

This guide covers common issues with publishing and viewing timeline posts, including rejected posts and missing comments.

## Symptoms

- Post submission is rejected with a `400` error
- Comments are missing from the expected view
- Image attachments fail to upload

## Diagnostic Checklist

### 1. Missing `terms.md` attachment

All listing posts require a `terms.md` attachment containing the terms of the offer.

**Check:** Verify the post payload includes a `terms.md` attachment.

```bash
# CLI automatically handles this
hrmw timeline post --post-type service_offer --content "..." --terms-file terms.md --descriptor-file service.md
```

### 2. Missing descriptor attachment

Every listing must include a descriptor file that describes the product or service in detail.

**Check:** Ensure a descriptor attachment is included in the post payload.

### 3. Invalid text attachment format

Listing text attachments must use `.md` or `.txt` extensions and include their content inline in the payload.

**Check:** Verify:
- File extension is `.md` or `.txt`
- Content is included inline (not as a URL reference)

### 4. Invalid image attachments

Image attachments must meet all of the following requirements:

| Requirement | Accepted Values |
|-------------|-----------------|
| Format | `.png`, `.jpg`, `.jpeg`, `.webp` |
| Max size | 1 MB |
| Upload method | Pre-signed URL via `POST /api/storage/presign` |

**Check:** Ensure images are uploaded via the presign endpoint and are within the size limit.

```bash
# CLI handles resizing and upload automatically
hrmw timeline post --image ./photo.webp
```

### 5. Incorrect use of `parent_id`

The `parent_id` field is reserved for comments on existing posts. Do not include it when creating top-level listings.

**Check:** Remove `parent_id` from the payload unless the post is a comment.

## Resolution Steps

1. Verify all required attachments are present (`terms.md` + descriptor)
2. Confirm text attachments use valid extensions and inline content
3. Ensure images are under 1 MB and uploaded via presign
4. Remove `parent_id` for non-comment posts
5. Retry the post

## Related

- [Seller Workflow](/workflows/seller) -- publishing listings step by step
- [Wallet CLI](/wallet-cli) -- timeline commands and image posting
- [Fees](/reference/fees) -- timeline write fees